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rum de discussion, le developpeur debutant apprendra a installer le 
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plets, servlets et JSP, exploiter une base de donnees, concevoir des 
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PHP objet et XML. 

Stephane MARIEL - N°1 1234, 2004. 

L'etude de cas, une application IRC de rencontre sur le Web, tire 
parti de tout ce qu'offre PHP 5 : design patterns et objets, creation 
de documents XML a la volee, transformation XSL pour des sites 
accessibles meme depuis votre telephone mobile, utilisation de SQ- 
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K. AYEVA, 0. DECKMYN, P.-J. GRIZEL, M. RODER 

N°11393, 2004, 216 pages. 
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edition montre comment creer et personnaliser un site intranet d'en- 
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differents types de contenu, mettre en osuvre des services de work- 
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formulaires. 
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UML est un outil simple et universel : nullement reserve aux appli- 
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Les Cahiers du programmeur ASP.NET 
Thomas PETILLON - N°1 1210, 2003. 
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securiser et deployer la base. 

Les Cahiers du programmeur PHP/Java Script 

Philippe C HAL EAT et Daniel CHAR NAY - N° 11089, 2002. 
En une douzaine d'ateliers pratiques, allant de la conception d'aides 
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passant par les templates PHP et les annuaires LDAP, on verra 
qu'autour de formulaires HTML, on peut sans mal realiser des ap- 
plications legeres ergonomiques et performantes. 
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conception de services web. 
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PHOTOCOPILLAGE 
TUE LE LIVRE 



Avant-propos 



Java est ne il y a environ huit ans. Depuis lors, le petit monde de l'informatique 
voit en ce langage un trouble-fete, lent pour certains, revolutionnaire pour 
d'autres. Loin des mythes et des legendes urbaines, ce langage a fait sa place 
dans le monde de l'entreprise. Pendant ce temps, le loisir d'un jeune doctorant 
finlandais se transformait en enjeu economique colossal : Linux. Avec ce nou- 
veau systeme d'exploitation, le monde decouvrait un concept jusque-la reserve a 
quelques idealistes : le logiciel libre. Les annees 1990 ont fait entrer l'informa- 
tique dans une ere industrielle et ce nouvel age pour l'informatique amene les 
contraintes inherentes a toute industrie : procedures et qualite. 



Quel est I'objectif de cet ouvrage ? 

Ce livre expose comment aborder un developpement Java avec une demarche 
professionnelle et presente des outils (Open Source pour la plupart) apportant 
de reels plus dans cette optique de qualite professionnelle. Cela signifie que 
l'application ne doit pas se contenter de faire ce que Ton souhaite a la base, mais 
quelle doit en plus etre maintenable done documentee et codee suivant un for- 
malisme bien etabli. La reutilisation logicielle doit etre une preoccupation per- 
manente, non pas comme une contrainte, mais comme la consequence meme de 
la methodologie de developpement adoptee. 

Pourquoi une telle demarche ? L'heure n'est plus aux developpeurs isoles au fond 
de leur garage. Le developpement de logiciels etant entre dans une ere indus- 
trielle, il est indispensable de se doter de methodes et d'outils a meme de satis- 
faire les besoins inherents a ce changement de phase. Le travail en equipe 
implique ainsi des outils (gestion de versions), charte de codage, documentation 
(javadoc et diagrammes UML). 



De plus, le monde de l'entreprise n'etant pas le moins du monde caritatif, il est 
bon d'envisager un projet informatique sous un jour financier en prenant en 
compte : 

• le cout des bibliotheques utilisees (utiliser des solutions libres ne fait que 
favoriser la diminution du cout) ; 

• la reduction des couts de maintenance (ideal si elle est faite par d'autres) ; 

• le facteur qualite, car dans un environnement oil tout est quantifie, il est bon 
de se doter d'outils nous permettant de nous premunir contre les mauvaises 
surprises (absence de commentaires dans le code, variables orthographiees 
sans logique, etc.). 

II faut en fait rappeler un principe universel (en informatique) etaye par des 
statistiques : moins on ecrit de code, moins il y a de bogues. Une etude sur de 
nombreux projets (utilisant divers langages dans divers environnements) avait 
montre que Ton pouvait s'attendre a : 

• un bogue majeur toutes les 1 000 lignes de code ; 

• un bogue toutes les 100 lignes de code ; 

• un bogue mineur toutes les 10 lignes de code. 

II est done crucial de comprendre qu'il vaut mieux ecrire peu de code teste et 
qualifie longuement, plutot que livrer une grosse masse de code non teste. De la 
decoule le souci permanent a travers cet ouvrage d'utiliser des solutions stan- 
dards, des termes standards, voire des logiciels ou protocoles qui le sont aussi. 
Pour ce faire, le lecteur va suivre un fil directeur sous forme dune application 
simple (gestion des bookmarks d'une societe) pour une societe fictive : 
BlueWeb. Cette application nous permettra de mettre en oeuvre du code et des 
outils s'inscrivant dans la ligne de conduite enoncee precedemment. 
Evidemment, le format de l'ouvrage ne permet pas de presenter exhaustivement 
toutes les notions qui y sont evoquees (programmation par contrats, eXtreme Pro- 
Cet ouvrage essaie avant tout d'apporter des gramming, EJB, servlets, etc.). Le lecteur pourra se reporter aux annexes biblio- 
reponses concretes a des problemes recurrents, graphiques ainsi qu'aux diverses annotations tout le long du livre. En resume, il 
notamment ceux exprimes sur le Web. s'agit de proposer des solutions et surtout un etat d'esprit pragmatiques permet- 

► nntp://fr.comp.lang.java tant d'aborder plus facilement le developpement avec les technologies Java. 



A qui s'adresse cet ouvrage ? 

Ce livre doit permettre a un jeune developpeur (professionnel ou etudiant), pos- 
sedant les rudiments necessaires au developpement en Java (compilation, bases 
du langage), de trouver des exemples concrets de mise en ceuvre de differents 
themes tels que : 

• les design patterns (tout au long de l'ouvrage) ; 

• les architectures logicielles modernes (3 couches et extensions) dans le cha- 
pitre dedie a ce sujet (chapitre 2). 



VI 



Des introductions a des techniques telles que l'utilisation de la servlet API 
(chapitre 4) ou des EJB (chapitre 5), enrichies de pointeurs vers des sites web et 
references bibliographiques, doivent permettre d'apprehender ces technologies. 
Enfin, un lecteur experimente tel qu'un chef de projet ou un responsable qualite 
doit trouver a travers le chapitre 7 des elements lui permettant d'accroitre sa 
maitrise sur la qualite de son projet. 

Tout le long de l'ouvrage, Ant, l'outil de gestion du processus de compilation du 
projet Apache, sera utilise pour guider le lecteur vers des solutions garantissant 
la portabilite annoncee par Java. Cet outil propose des solutions simplifiant 
diverses taches quotidiennes telles que : 

• la compilation et la creation de documentation ; 

• le deploiement (tant cote client que serveur) ; 

• l'obtention de metriques et indicateurs sur un projet. 

Done, quel que soit votre role dans un projet Java, vous trouverez matiere a 
gagner du temps et de la qualite (automatisation de taches repetitives). 
De plus, des bibliotheques telles qu'Oro ou Rachel proposent de reelles alternatives 
Open Source a des solutions proprietaires. Ainsi, a travers la societe fictive BlueWeb, 
on peut voir l'esquisse d'un nouveau mode de travail par lequel les equipes de deve- 
loppement obtiennent des resultats probants tout en contribuant a leffort dune 
communaute. Car tout probleme signale, toute documentation donnee ou toute 
publicite offerte a ces projets par leur utilisation ne peut que les renforcer et, par un 
effet boule de neige, rendre encore plus perenne la solution adoptee. 

Cet ouvrage espere pouvoir briser la timidite de certains decideurs vis-a-vis des 
solutions Open Source qui me semblent atteindre (pour certains projets du 
moins) une qualite difficile a trouver dans la plupart des outils du commerce. 



A LA LOUPE Les incontournables design patterns 

L'expression « design patterns », que nous ne traduirons pas, provient du titre d'un ouvrage 
d'architecture de M. Christopher Alexander eta/.. Cet ouvrage s'efforce d'apporter une semanti- 
que commune lors de la construction de cites pour differents problemes recurrents en ce 
domaine. Cette idee a ensuite ete reprise au debut des annees 1990 par Erich Gamma, Richard 
Helm, Ralph Johnson et John Vlissides dans leur ouvrage Design Patterns : catalogue de modeles 
de conception reutilisables. Cet ouvrage est un element absolument indispensable qui a sa place 
au pantheon des ouvrages en informatique. Cette idee d'essayer d'apporter un vocabulaire, une 
moderation et une implementation pour des problemes courants respecte vraiment la philoso- 
phic que Ton va essayer de mettre en pratique au cours de cet ouvrage : la reutilisation. II 
importe de bien comprendre qu'en essayant de proposer (et non d'imposer) un vocabulaire uni- 
versel pour des problemes qui le sont autant (s'assurer de I'unicite d'un objet par exemple pour 
le pattern Singleton), ce livre permet de regler les problemes de communication apparaissant au 
cours d'un projet (au sein d'une equipe, avec un client, avec d'autres developpeurs). UML permet 
d'aller un cran plus loin, en proposant un formalisme commun de representation de vos modeli- 
sations. En adoptant une telle philosophie, votre travail sera plus simple et plus efficace, car 
votre code source comme vos modeles seront plus faciles a comprendre et done plus efficaces au 
sens de la productivite pour votre entreprise. II s'agira done ici, non pas de reecrire ce qui I'a deja 
ete (avec infiniment plus de talent et d'imagination), mais de proposer quelques mises en prati- 



Structure de I'ouvrage 



De ('utilisation de termes anglais 

Nous avons souvent garde les termes anglais, car il 
nous semble indispensable de donner au lecteur des 
references facilitant son apprentissage par la suite, 
dans un contexte oil 95 % des documentations dis- 
ponibles sont en langue anglaise. Par exemple, nous 
n'avons pas traduit le terme design pattern par 
motif ou modele de conception afin de faciliter les 
recherches du lecteur interesse par le sujet. 



L'ouvrage prend pour pretexte un projet virtuel afin de conduire le lecteur de 
bout en bout a travers toutes les couches de l'architecture proposee. 

• L'introduction presente la societe fictive, l'equipe et les specifications du 
projet. 

• Le chapitre 1 decrit les traits de l'architecture retenue. Toutes les couches 
seront passees en revue. Ce chapitre presente les points cles nous poussant a 
adopter des architectures evoluees en lieu et place des architectures du type 
deux couches. 

• Le chapitre 2 donne une vue d'ensemble de l'environnement de developpe- 
ment (Ant et CVS) et introduit le projet Commons d' Apache (de quoi rem- 
plir vos besaces de developpeurs Java). 

• Le chapitre 3 s'interesse a la partie graphique (client) de l'application. II y 
sera question entre autres du probleme de la coherence des saisies utilisateur. 
On detaillera le choix d'une nouvelle bibliotheque graphique, SWT (issue 
du projet Eclipse, un outil de developpement). 

• Le chapitre 4 decrit la couche de presentation des donnees (utilisation de la 
servlet API). II sera question de l'utilisation du XML comme format 
d'echange entre les couches, ainsi que d'un design pattern particulier : le 
pattern Commande. 

• Le chapitre 5 s'interesse aux objets metier (EJB) et surtout a une facon ori- 
ginale de les coder permettant une meilleure productivite et un gain en por- 
tabilite. Loutil utilise, XDoclet, nous donnera l'occasion d'introduire le con- 
cept des doclets Java. 

• Le chapitre 6 decrit comment mettre en place un outil de deploiement 
d'applications a travers un reseau via l'utilisation de Java Web Start. Evi- 
demment, on s'interessera aux problemes classiques lies a ce sujet (gestion 
des versions, mise a jour) et, d'un point de vue plus pragmatique, aux couts 
induits pour un chef de service. 

• Le chapitre 7 s'interesse a des outils permettant de controler la qualite sur 
un projet Java. Ainsi, il s'agira de proposer des solutions concretes permet- 
tant d'assurer la conformite de vos sources avec les conventions de nommage 
adoptees par votre equipe ou encore d'exposer un outil permettant de fournir 
des indicateurs sur le niveau de conception/reutilisation d'un paquetage Java 
(regroupement hierarchique de classes au sein d'unites). 

• Le chapitre 8 proposera l'examen retrospectif d'une partie du code de 
l'application BlueWeb. 

• Le chapitre 9 revient sur les technologies utilisees qui permettent de traiter 
superficiellement des frameworks web ainsi que des micro-conteneurs. 

Bien entendu, on utilisera de facon permanente Ant et on eclairera des que 
necessaire les modeles de conception employes. 
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Introduction a I'etude de cas 

et a J2EE 



En guise d'introduction, nous presenterons le contexte de 
notre etude de cas : l'entreprise virtuelle BlueWeb, son projet 
et son equipe de developpement. Ce chapitre sera aussi 
pretexte a une justification des technologies J2EE au regard de 
technologies plus anciennes. 



SOMMAIRE 

► BlueWeb : une societe virtuelle 

► L'equipe de developpement 

► Technologies et methodologie 

► L'application de I'etude de cas 

MOTS-CLES 

► Projet pilote 

► Gestionnaire de signets 
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= Ce chapitre decrit une entreprise n'ayant d'exis- 
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^ JSP (Java Server Pages) 

Technologie permettant de definir des pages web 
creant du contenu dynamique. Cette API fait partie 
de celles regroupees au sein des specifications 
J2EE. 



//. Servlet 

Composant web gere par un container et permet- 
tant la generation de contenu dynamique. Le 
chapitre 4 presente cette notion et signale des 
sites web ou des ouvrages de reference sur ce 
sujet. Cette API fait egalement partie des specifi- 
cations J2EE. 



BlueWeb : r entreprise 

BlueWeb est une entreprise specialisee dans la conception de sites Internet 
(intranet) cles en main pour des clients importants (banques, industries et admi- 
nistrations). Pionniere du Web en France, elle doit dorenavant operer un tour- 
nant cle de son histoire et fournir des solutions complexes (techniquement) en 
vue de realiser des portails en intranet/extranet federant diverses applications 
(solutions proches de l'EAI). 

A EAI (Enterprise Application Integration) 

Norn designant les techniques qui permettent d'integrer differentes applications developpees sans 
connaissance les unes des autres. II s'agit done d'utiliser des passerelles standards, telles que XML 
ou le protocole HTTP, pour transformer en un tout coherent une serie d'applications heterogenes. 



L'entreprise se prepare done a faire un veritable saut technologique en abandon- 
nant les competences maintenant obsoletes qui avaient fait sa renommee : 

• HTML; 

• scripts JavaScript ; 

• scripts CGI, peu reutilisables et peu stirs. 

HTML et JavaScript ne sont pas obsoletes dans le sens ou toutes les pages web 
du monde sont codees en HTML et souvent enrichies par des scripts 
JavaScript, mais ces seules technologies ne peuvent plus repondre aux besoins 
des applications d'aujourd'hui. C'est pourquoi, via des technologies comme les 
JSP/servlets ou les ASP dans le monde Microsoft, les pages HTML sont bien 
plus souvent dynamiques (produites dynamiquement par des programmes) que 
statiques (realisees directement avec un editeur de texte ou un outil dedie, 
comme Dreamweaver ou Quanta+). 

Lexploitation de formulaires et l'envoi de courriers electroniques font partie de 
ces taches autrefois reservees aux scripts CGI (codes en C ou en Perl par 
exemple) mais qui, pour des raisons de montee en charge, de reutilisation et 
aussi de securite, font maintenant les beaux jours des JSP/servlets. En fait, J2EE 
(voir encadre) apporte aux entreprises les avantages lies a toute technologie objet 
par rapport a des langages proceduraux comme le C, tels que la reutilisation et la 
facilite de maintenance. De plus, de par sa conception, Java est un langage stir et 
portable. Ceci resout un des problemes lies a l'utilisation des CGI : les failles 
de securite (par exemple les « buffer overflow », resultats d'une mauvaise con- 
ception, qui permettent a des programmeurs ruses d'introduire et de lancer du 
code indesirable sur le serveur). 

//. EJB (Enterprise JavaBeans) 

Norn d'une specification de Sun (actuellement en version 2.1) qui vise a definir une bibliotheque 
permettant d'obtenir des composants metier cote serveur. Ces composants sont deployes au sein 
d'un conteneur pouvant leur fournir divers services de haut niveau comme la prise en charge de 
la persistance ou celle des transactions. 
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B.A.-BA Qu'est-ce que J2EE ? 

J2EE (Java 2 Enterprise Edition) regroupe a la fois un ensemble de bibliotheques (servlets/EJB/ 
JSP) et une plate-forme logicielle. C'est une version de la plate-forme Java specialement etudiee 
pour les problemes des applications d'entreprise. Elle fournit de nombreuses solutions au niveau 
de la gestion des problemes recurrents dans ce domaine : securite (API JAAS), prise en charge 
des transactions (API JTA et gestion declarative dans les EJB). JDBC fait aussi partie de ces tech- 
nologies. Actuellement, la derniere version des specifications disponible est la 1 .4. 



Cependant, avant de migrer toutes ses equipes de developpement vers J2EE, 
BlueWeb veut utiliser ces technologies sur un projet test afin d'en retirer une 
experience capitalisable pour son futur. Pour cela, quelques developpeurs de 
l'equipe Recherche & Developpement ont ete choisis. 



Projet pilote 



Ce type de projet est denomme projet pilote dans 
de nombreuses entreprises. II fait partie de I'arse- 
nal des managers qui doivent faire face a un chan- 
gement radical de technologie. . . 



L'equipe de developpement 



L'equipe de developpement choisie est composee de 5 personnes : 

• Bob, le chef de projet, est un programmeur C emerite et, via son experience 
du Perl, il a acquis une expertise dans le maniement des expressions regulie- 
res. Son bon sens et son pragmatisme sont les garde-fous de BlueWeb 
depuis des annees. Le monde de J2EE, et en particulier la foule de projets 
issus de l'Open Source, le fascinent... 

• Yann est un ancien stagiaire fraichement sorti de l'ecole. II est tombe dans 
l'objet quand il etait tout petit et « parle » tres bien UML et Java. II va etre 
en charge de la partie cliente et sera associe a Steve, qui devra assurer le 
deploiement/packaging de l'application. 

• Pat est un specialiste des bases de donnees. Programmeur C et DBA certifie 
Oracle et Sybase, il a le profil type du codeur cote serveur. 

• Comme de coutume pour les projets au sein de BlueWeb, l'equipe de deve- 
loppement devra soumettre code et documentation a l'approbation du res- 
ponsable qualite de la societe : Michel, homme rigoureux entre tous. 



A DBA (DataBase Administrator) 

Administrateur de bases de donnees : nom donne 
aux personnes qui creent et maintiennent de gros- 
ses bases de donnees. 



ALA LOUPE Java et l'Open Source 

Java a connu un succes tres rapide, et ce au moment meme ou Linux introduisait la notion 
d'Open Source aupres du grand public. Cette synergie a alors donne le jour a de nombreux pro- 
jets communautaires (au sens ou un ensemble de developpeurs issus des quatre coins de notre 
planete participent a un meme projet dans le seul but d'ameliorer tel ou tel aspect de leur tra- 
vail/passion). Beaucoup de projets sont nes, beaucoup sont morts, mais la dynamique n'est pas 
retombee et aujourd'hui, certains d'entre eux constituent de reelles forces de proposition au sein 
de la communaute d'utilisateurs Java. Ainsi, Exolab accueille differents projets (Castor par exem- 
ple), de meme qu'Apache accueille Ant, Lucene, Tomcat, Oro.... II faut preciser que l'Open 
Source n'est en rien une specificite de Java, puisque les premiers projets de ce type sont Linux, 
Apache, Samba, Sendmail... 
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Technologies et methodologie 



Ce projet doit etre l'occasion de mettre en oeuvre pour la premiere fois les tech- 
nologies J2EE (servlets et EJB) et d'adopter une approche methodologique for- 
tement teintee par les principes majeurs de 1'eXtreme Programming. 



METHODE L'eXtreme Programming 

L'eXtreme Programming est un mouvement recent (1998) tres original, puisqu'il s'agit a la fois 
d'une methodologie et d'outils concrets visant a prendre enfin en compte dans un projet un 
aspect oublie par les autres mentors de I'objet : I'homme. Avec certains preceptes et certaines 
pratiques courantes, ce mouvement tache d'ameliorer la communication et la qualite du code. 
II faut quand meme preciser qu'a la base, les pratiques decrites par les gourous de I'eXtreme Pro- 
gramming sont tres bien adaptees a de petites equipes, pour des projets ou les developpeurs 
sont en contact avec le client final (pas toujours vrai). 

Vous trouverez par la suite un peu plus d'informations sur ce mouvement tres interessant et Ton 
ne saurait que trop chaudement recommander la lecture de I'ouvrage suivant : 
IB J.-L. Benard, L. Bossavit, R. Medina, D. Williams.- Gestion de projet extreme Programming, 
Eyrolles 2002. 

Les notions les plus largement appreciees au sein de l'equipe sont le travail en 
binome {pair programming) et l'importance accordee aux tests unitaires 

Certains diagrammes UML seront utilises pour fixer le vocabulaire commun, 
delimiter avec precision le contour fonctionnel de l'application et faciliter le 
codage. 

A ce titre, il va done etre question de realiser une application facilement distri- 
buable. 

Pour cela, le chapitre 6 de cet ouvrage presente l'optique de BlueWeb, qui a deja 
eu ce type de preoccupations et a done une experience quelle veut utiliser afin 
de se premunir contre les problemes frequemment rencontres. Bien evidem- 
ment, il s'agira de minimiser les interventions humaines (trop onereuses) et 
d'utiliser le Web comme media de communication pour les mises a jour. 

L'interface graphique sera developpee en utilisant une bibliotheque assez 
recente mais qui fait deja beaucoup de bruit : SWT. II s'agit la en fait de la base 
du projet Eclipse, projet initie par IBM et dont le developpement est assure par 
un consortium. 

L'idee d'utiliser cette bibliotheque plutot que la tres documentee Swing 
(devenue la bibliotheque standard pour les interfaces graphiques en Java) pro- 
vient du fait que BlueWeb a la preuve (avec Eclipse) que Ton peut faire un tres 
bon produit avec cette bibliotheque. 

II s'agit done de mesurer, sur un projet concret, l'impact sur une planification de 
projet d'une telle bibliotheque en matiere de temps d'adaptation, d'obtention de 
reponses et d'informations. II s'agira aussi de mesurer la stabilite de cette biblio- 
theque. Toutes ces questions ne peuvent trouver reponse que par le biais d'un 



reel projet et, etant donne 1'importance de la question, il vaut mieux utiliser un 
projet pilote qu'un reel projet client pour mettre en oeuvre cette bibliotheque. 
Pour BlueWeb, il est evident que l'utilisation de Swing sur un projet aussi 
simple aurait ete une solution de facilite, car l'abondance de la documentation 
(livres/ articles) aurait permis de surmonter les rares difficultes posees parl'inter- 
face graphique a realiser. Cependant, cela n'aurait nullement permis de se forger 
une opinion sur les qualites/defauts de SWT et done n'aurait contribue qua 
repousser un probleme qui de toute evidence se posera bientot pour BlueWeb. 

Avec une optique similaire, BlueWeb decide de mettre en ceuvre les EJB. II 
s'agit de voir comment les mettre en oeuvre et de pouvoir capitaliser des expe- 
riences concretes d'utilisation de ces composants. D'autres solutions permet- 
traient de gerer la persistance des donnees : 

• l'API JDBC (Java DataBase Connectivity) ou via iBatis ; 

• certains produits comme Hibernate, Cayenne JDO, KodoJDO, Speedo ou 
encore TopLink ; 

• la norme JDO (Java Data Objects) de Sun. 



ATTENTION JDO et Castor JDO 

II n'y a pas d'erreur dans la liste ci-dessus (quelques omissions) : par un caprice du sort, il se 
trouve qu'un produit (castor JDO) porte un nom aujourd'hui proche de celui d'une norme de Sun. 
En fait, le produit et la norme visent tout deux a assurer la persistance d'objets Java, mais le pro- 




L'utilisation des EJB un jour ou l'autre semble evidente pour BlueWeb et, de 
nouveau, ce projet pilote semble etre l'occasion parfaite. En choisissant cette 
solution, on pourra compter sur des conclusions etayant le savoir-faire de 
BlueWeb sur des questions comme : 

• la performance des EJB (en mode CMP) ; 

• la facilite et le temps de codage ; 

• La portabilite reelle. 

Enfin, le choix d'adopter une couche de presentation realisee par des servlets 
Java est du a 1'importance de HTTP dans l'informatique d'aujourd'hui. 

Plus anecdotiquement, le code client se devra de mettre en ceuvre le produit 
JUnit (support des tests unitaires), et ce afin de mesurer concretement les bene- 
fices d'une telle approche, ainsi que l'impact sur la gestion d'un projet. Pourquoi 
se contenter d'une portion seule du code ? Avec ce projet, BlueWeb ne pretend 
pas chercher a atteindre la reutilisation mais juste a tester grandeur nature diffe- 
rentes solutions ; il en decoule qu'il n'est nullement necessaire d'imposer l'utili- 
sation de ce framework a toute l'equipe si d'aventure l'experience s'averait nega- 
tive avec ce produit. 
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OUTIL iBatis 

iBatis se trouve dans I'incubator Apache. 

► http://incubator.apache.org/projects/ibatis.html 



OUTILS Hibernate, Cayenne JDO, 
KodoJDO, Speedo et TopLink 

► www.hibernate.org 

► www.objectstyle.org/cayenne/ 

► www.solarmetric.com 

► http://speedo.objectweb.org/ 

► www.oracle.com 



B.A.-BA Framework 

Ce mot designe un ensemble de classes destine a 
realiser une fonction ou rendre un service, et ce de 
maniere reutilisable. La distinction avec une API 
est un peu subtile, mais on peut caricaturer en 
constatant qu'un framework est plus qu'une API. 
En citant la definition donnee dans I'ouvrage 
Design Patterns : « Un framework est un ensemble 
de classes qui cooperent et permettent des con- 
ceptions reutilisables dans des categories specifi- 
ques de logiciels. ». 
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[.'application 



//. Signets 

Bookmarks en anglais : correspond aux favoris sous 
Internet Explorer ou marque-pages sous Mozilla 
Firefox. Ces petites fiches permettent de se depla- 
cer rapidement vers certains sites web et de les 
classer par themes ou centres d'interets. 



B.A.-BA LDAP (Lightweight Directory 
Access Protocol) 

LDAP est un standard et non un produit. Differen- 
tes implementations sont disponibles, comme 
OpenLDAP qui est un produit libre, ou encore le 
serveur fourni dans Exchange de Microsoft, Micro- 
soft Active Directory. 



B.A.-BA Intel-nationalisation 

L'internationalisation, ou H8n en abrege pour les 
americains, designe le modele de developpement, 
I'API et les methodes de conception necessaires a 
la prise en charge de plusieurs langues dans une 
application. Parmi les differents concepts en pre- 
sence, on peut citer pele-mele : 

• le modele de conception (design pattern) 
Adapter ; 

• I'utilisation de cles en lieu et place de tous les 
labels et autres messages d'erreur ; 

• les classes ResourceBundle, Locale et 
SimpfeDateFormat, qui peuvent servir de 
briques de base lors de I'elaboration de sche- 
mas ou frameworks maison prenant en charge 
de telles contraintes. 



Description des fonctionnalites 

L'application doit permettre la saisie, la mise a jour et 1'interrogation de signets. 
Ainsi, il sera possible de factoriser la recherche et l'archivage des adresses fre- 
quemment utilisees dans l'entreprise. En effet, jusqu'a present, tous les 
employes de la societe utilisaient les fonctionnalites de leur navigateur web 
(Netscape ou IE), ce qui avait l'inconvenient de multiplier l'espace disque 
(secondaire) mais aussi de faire perdre du temps et du savoir, car de nombreux 
sites peuvent avoir de l'interet pour de nombreux employes. Ainsi, pour les 
developpeurs, des portails web comme celui d'IBM, sont des sites qu'ils ajoutent 
tous dans leurs listes de favoris. 

Un annuaire d'entreprise du type LDAP permettrait ce type de fonctionnalites, 
mais le cout d'administration d'un tel applicatif lui ferait perdre tout interet et 
ne resoudrait pas pour BlueWeb la necessite d'apprendre a manipuler les nou- 
velles technologies. En effet, LDAP est une norme permettant de situer des 
informations dans un entrepot de donnees. Un exemple typique d'utilisation de 
LDAP est un annuaire d'entreprises pour lequel on dispose de cles de recherche 
(des noms) et qui permet d'obtenir diverses informations (telephone, fonction 
dans l'entreprise, salaire, etc.). Notre application pourrait naturellement etre 
reduite a peu de choses en utilisant une implementation de cette norme. Mais il 
ne faut voir en l'application qu'un pretexte a l'acquisition de competences et non 
un simple applicatif. 

La premiere version du logiciel ne prendra pas en charge des notions comme 
l'internationalisation, pour gagner du temps et de la simplicite. En effet, cette 
contrainte ne repond pas a un besoin pressant des clients (utilisateurs en interne) 
et n'apporte rien techniquement, mais elle demande du temps et de l'energie. . . 

Analyse des donnees 

Etant donne l'extreme simplicite du sujet, on peut se contenter d'une petite 
etude reduite a quelques lignes et quelques diagrammes pour comprendre la 
partie metier traitee par cette application. II s'agit en fait dans notre application 
de simplement entreposer, saisir et rechercher des fiches designant un site web. 

Pour BlueWeb (comme pour la plupart des autres societes), un signet est simple- 
ment le nom donne a l'ensemble suivant de donnees : 

• libelle ; 

• URL (adresse HTTP ou FTP) ; 

• description : commentaire sur le site. 

Evidemment, etant donne le nombre de signets par utilisateur (disons 400 en 
moyenne), la base de donnees globale peut atteindre les 15 000 signets, ce qui 



implique fatalement de classer par dossiers que nous appellerons themes, un 
theme etant alors la collection des donnees suivantes : 

• un libelle ; 

• une description (commentaire) ; 

• une liste (peut-etre vide) d'enfants (themes et/ou signets). 
Cela nous amene a degager une modelisation du type : 




• ElementApplicatif est une classe abstraite implementant l'interface 
ICerable, qui permet de regrouper les methodes communes a des objets 
gerables dans l'applicatif. 

• Les classes Signet et Theme sont des classes filles de ElementApplicatif. 

Cette modelisation nous conduit directement a la notion de modele composite 
(design pattern Composite), dans la mesure ou le diagramme fait apparaitre 
qu'un Theme peut accepter comme enfant tout type d'ElementApplicatif, c'est- 
a-dire un Theme ou un Signet. On peut noter a titre de remarque, pour les lec- 
teurs non familiers avec la norme UML, que ce schema adopte une notation 
officielle. Ainsi, le petit rectangle de commentaire balise «<comment»> utilise 
ce que Ton appelle une tagged-value en UML. Ici, comment est done une 
tagged -value particuliere, qui permet de preciser quel type de commentaire on 
veut utiliser De la meme facon, le rectangle situe au-dessus utilise une autre 
tagged-value, qui a la valeur description. Pour de plus amples informations sur 
UML, on ne peut que recommander les excellents ouvrages de Pascal Roques et 
en particulier, dans la meme collection que notre livre, le cahier du program- 
meur UML - Mode'liser un site e-commerce. 



Specifications techniques 



L'application ne requiert pas de gestion de differents profils utilisateurs. Autre- 
ment dit, il n'y aura pas de gestion de privileges (droits d'acces a certaines don- 
nees ou fonctionnalites) et done pas d'ecran d'invite permettant a l'utilisateur 
d'entrer dans l'applicatif apres saisie d'un nom et d'un mot de passe. 

Une architecture du type 3-couches etendue doit permettre : 

• une vaste possibility de deploiements (sur une machine ou plusieurs ) ; 

• un deploiement via le Web pour ne pas avoir a gerer des mises a jour via 
CD-Rom et intervention humaine ; 

• le fonctionnement en mode client/serveur sans necessite d'installer de proto- 
coles proprietaries sur le poste client ; 

• une interface cliente riche (done non reduite a de simples pages HTML) ; 

• l'utilisation d'un serveur d'applications JBoss + Tomcat, afin de se familiari- 
ser avec les technologies definies dans la norme J2EE ; cet outil a le merite 
d'etre Open Source, done simple a obtenir (librement accessible sur Internet 
sans investir financierement dans des licences logicielles) et a installer (pas 
de cle necessitant un contact avec un service commercial) ; 

• l'utilisation d'un outil de make, de maniere a pouvoir maitriser la compilation 
et les etapes suivantes du cycle de vie du produit, et ce independamment de 
tout outil de developpement (JBuilder, Eclipse ou tout autre IDE) ; 

• l'utilisation d'une couche d'abstraction de la base de donnees, qui doit per- 
mettre l'utilisation d'une vaste gamme de produits du marche (Sybase, 
Oracle, SQL Server ou PostgresSQL). 



OUTILS JBoss et Tomcat 

JBoss est un serveur d'applications Open Source qui est maintenant a I'age de la maturite, indis- 
cutablement de qualite professionnelle. C'est un conteneur EJB conforme aux specifications de la 
version 2.1 de cette norme (la derniere publiee) qui propose un bundle (en marketing signifie 
deux produits livres ensemble) avec le servlet-engine le plus populaire : Tomcat. 
Tomcat est lui aussi un projet tres populaire et permet d'obtenir un servlet-engine conforme aux 
dernieres specifications (2.4). Ces deux produits sont de veritables references et leur succes est 
atteste par le nombre de recompenses qu'ils ont obtenues. 

► http://www.jboss.org 

► http://jakarta.apache.org/tomcat 



En resume 



Pour planter un decor, nous avons constitue une equipe virtuelle dans une 
societe qui Test tout autant, mais en introduisant des concepts et des pratiques 
qui ne le sont pas. Ainsi la notion de projet pilote est-elle une realite. Le voca- 
bulaire important a egalement ete explique. Nous avons aussi presente succinc- 
tement quelques-uns des produits que nous rencontrerons tout au long de 
l'ouvrage. 

La reussite d'un projet pilote tient dans le dosage subtil de differents 
ingredients - un peu comme dans l'art du cocktail : 

• un cahier des charges simple ; 

• une definition claire des obstacles en termes d'acquisition de connaissances 
(difficultes techniques et outils) ; 

• une bonne definition du planning ; 

• une equipe coherente et son adequation avec les objectifs vises. 



chapitre 




Une architecture a 5 
couches pour BlueWeb 



Les choix techniques et leur justification doivent non 
seulement obeir a des contraintes techniques, mais aussi bien 
souvent a des arguments visant a rassurer les decideurs quant a 
leur investissement, comme nous le verrons dans le cadre de 
notre projet fictif BlueWeb. 
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► Modele a 5 couches 

► Modeles a 2 et 3 couches 

► Description de I'environne- 
ment choisi par BlueWeb 
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► Qualite 

► Deploiement 



Un modele a 5 couches pour le projet de 
gestion des signets 

L'application de gestion des signets etant un projet pilote pour BlueWeb, 
l'equipe en charge de ce projet se doit d'adopter une facon de travailler, de coder 
et de documenter le projet qui deviendra un exemple pour les developpements 
futurs. Ceci dit, cette application doit aussi servir a defricher les nouveaux 
espaces ouverts par ce changement de technologie, l'architecture globale du 
projet entend bien s'affranchir des serieuses limitations rencontrees precedem- 
ment. 

Ce type de modeles est issu d'une extension naturelle des modeles dits a 3 cou- 
ches. Avant de le presenter, revenons un peu en arriere. L'apparition des techno- 
logies objet et l'importance croissante du Web ont vu la fin des environnements 
articules autour des modeles de developpement dits a 2 couches. C'est-a-dire la 
fin des interfaces clientes assurant a la fois l'affichage des informations, les 
interactions avec l'utilisateur mais aussi l'application de la logique metier et les 
appels a la base de donnees sous-jacente. Trop cheres en cout de maintenance et 
deploiement, peu adaptees a la montee en charge, ces architectures monoli- 
thiques ont cede la place aux modeles dits a 3 couches. Commencons par revenir 
sur le modele a 3 couches en le comparant au modele a 2 couches. 

Le modele a 5 couches, objet de ce chapitre, est done une variante du modele a 
3 couches separant encore plus strictement les responsabilites : 

• couche cliente limitee a l'affichage/interactions utilisateur ; 

• couche de presentation des donnees : partie serveur rendant possible un 
acces a tout type de partie cliente (client leger Web, application C++ ou 
encore client riche Swing) via un protocole basique (HTTP) aux services 
metier (ajouter un signet ou crediter un compte) ; 



LES BASES Modeles a 2 et 3 couches 

La figure ci-contre permet de schematiser les differences entre ces 
deux types d'architectures logicielles. 

Elle illustre la maniere dont les responsabilites se trouvent ecla- 
tees et comment la montee en charge peut etre envisagee (une 
seule machine a besoin d'etre puissante). 
On peut alors envisager une veritable reutilisation des 
composants : 

• pour la partie cliente, des composants graphiques de haut 
niveau ; 

• pour la partie serveur, des composants « metier ». 



Figure 1-1 Modeles a 2 et 3 couches 



Comparaison entre modele 2 couches et modele 3 couches 
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services metier : composants reutilisables rendant des services strictement 
identifies. 

services techniques : composants permettant de realiser differentes riches du 
type persistance des donnees, gestion des transactions etc. ; 
stockage des donnees : c'est le role de la base de donnees. 

HTTP/XML , x 




Couche 
Presentation 



RMI/IIOP 



Couche metier 



JDBC driver 




RMI/IIOP 



Couche 
Technique 



Figure 1-2 Modele a 5 couches 

Ce type d'architecture permet done d'atteindre differents objectifs obsedant les 
DSI (Direction du systeme d'information) : 

• Deploiement simple, mise a jour aisee done les couts sont diminues (TCO). 

• Factorisation de la logique de l'entreprise. En effet, comme on le voit sur la 
figure 1-1, la logique embarquee dans une application adoptant une archi- 
tecture a 2 couches est melangee avec le code de gestion des evenements uti- 
lisateur et celui d'arfichage des elements graphiques. Bref, dans un tel con- 
texte, il est difficile de pouvoir pretendre reutiliser ce que Ton appelle la 
logique metier. 

• Delegation des parties ardues techniques (mapping objet/relationnel, ges- 
tion des transactions) a des composants specialement developpes par des 
experts dans le domaine. 

En consequence les architectures a 5 couches sont en parfaite adequation avec 
les nouveaux environnements d'execution d'applications, a savoir les serveurs 
d'applications. Les vendeurs de ce type de produits argumentent sur les themes 
recurrents de la montee en charge, de la facilite de deploiement et de la qualite 
des composants techniques. 



A TCO 



Acronyme anglais (Total Cost Ownership) signi- 
fiant cout total d'acquisition, la maintenance 
represente souvent un cout nettement superieur a 
celui de la phase de developpement d'un logiciel. 
Reduire le cout de la phase de maintenance/ 
deploiement implique alors une baisse de cet indi- 
cateur. Ceci est done une tres bonne nouvelle pour 
les DSI. 



ATTENTION ^utilisation 

Meme s'il est difficile de rendre le code metier 
reutilisable dans un environnement du type Del- 
phi ou Visual Basic, il n'est absolument pas 
impossible d'y arriver. II faut beaucoup de rigu- 
eur car cela va un peu a I'encontre de la philoso- 
phie de ces outils tres bien adaptes a ce que Ton 
appelle le RAD (Rapid Application Develop- 
ment). De meme, I'utilisation d'une belle archi- 
tecture 3 ou 5 couches n'implique en hen le 
caractere systematique de la reutilisation des 
composants mais il est plus facile d'y arriver... 
RAD est un precede de developpement visant a 
operer de maniere iterative, par prototypage, en 
precisant a chaque iteration. La philosophie de 
ce type de developpement est tres axee sur le 
retour des utilisateurs par rapport aux interfaces 
graphiques (realisees dans la phase precedente) 
et tente de limiter d'une phase a I'autre la reuti- 
lisation de code. 



A Mapping 



Ce terme anglais est trop delicat a traduire pour 
s'y risquer. II signifie I'etape de transformation 
d'un objet Java par exemple en une entree (ou plu- 
sieurs) dans la base de donnees et vice versa. 
Cette etape est imposee par I'ecrasante superiorite 
des bases relationnelles sur le marche des bases 
de donnees. 
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B.A.-BA Serveurs d'applications 

Cette expression en vogue depuis quelques annees 
est tres generique, trop peut-etre, car elle signifie : 
application publiant des services afin de les rendre 
utilisables via un reseau. Contrairement a un ser- 
veur FTP ou a un serveur de fichiers (Samba sous 
Unix ou NFS), un serveur d'applications ne se con- 
tente done pas de diffuser de I'information exploi- 
ted par le poste client puisqu'il « travaille ». II 
n'est pas dedie a un service particulier et execute 
des programmes a la demande de I'application 
cliente. 

Un serveur d'applications minimal pourrait etre 
une combinaison Apache + PHP puisqu'il permet- 
trait a des utilisateurs d'acceder a des services 
(boutique en ligne comme dans I'exemple du 
cahier du programmeur UML de Pascal Roques). 
Ces termes vont jusqu'a couvrir des implementa- 
tions beaucoup plus riches telles que de veritables 
implementations de la norme J2EE, comme 
Weblogic Server de BEA, WebSphere d'IBM etc. 
CO P.Roques, Cahier du programmeur UML, 
Eyrolles, 2002 



REFERENCE Apprentissage des servlets 

De nombreux sites et ouvrages vous permettront 
de vous familiariser avec les servlets mais le guide 
ou tutorial suivant est particulierement digne 
d'interet meme s'il date un peu. C'est ce site qui 
m'a permis de comprendre cette technologie il y a 
quelques annees de cela. 
► http://www.novocode.com/doc/servlet- 
essentials/ 



L'architecture proposee pour notre application exemple, la gestion des signets 
pour la BlueWeb compagnie, est une architecture reposant sur un modele a 5 
couches deployee au sein d'un serveur d'applications compatible avec les specifi- 
cations J2EE. Cette application etant un projet pilote pour la societe, on cher- 
chera a respecter au plus haut point les specifications de Sun et ce, afin de jauger 
l'adequation des normes avec les besoins ressentis lors de projets sur le terrain. 
Les specifications J2EE sont accessibles sur le site de Sun a l'adresse : 
► http://java.sun.eom/j2ee/1 .4/docs/tutorial/doc/ 

Les sections suivantes vont examiner l'une apres l'autre les differentes couches 
logicielles en presentant la solution retenue par BlueWeb pour l'implementation 
au niveau de I'application. 

Couche de presentation des donnees : 
servlets 

Cette technologie simple et robuste, nous permettra d'exposer nos services 
metier via une couche HTTP tres simple d'acces (en utilisant un protocole stan- 
dard, on s'assure de ne pas necessiter des installations difficiles sur les PC de 
bureau) sous forme de XML, e'est-a-dire presenter sous un format XML des 
objets manipules cote serveur. Les servlets ont done un role de presentation des 
donnees (transformation en XML) ainsi qu'une obligation de decouplage entre 
le client et la partie serveur, ce decouplage etant assure par le protocole 
« standard » utilise pour atteindre une servlet : HTTP. Cette couche nous per- 
mettrait aussi de gerer l'authentification des utilisateurs et de conserver leurs 
parametres personnels en memoire par utilisation de sessions HTTP. 

Cette couche a done pour vocation de rendre les installations des postes clients 
moins complexes et totalement independantes de notre application. Ceci evite 
l'utilisation de protocoles (IPX/SPX), RMI-IIOP) qui entraineraient des depla- 
cements de techniciens sur les postes clients et done des augmentations des 
couts d'administration. Dans un contexte d'entreprise, on peut esperer qu'au 
moins une couche TCP/IP soit installee sur le poste client. Sans elle, le PC ne 
peut pas communiquer avec un reseau standard, et ne permet done pas faeces a 
Internet, la messagerie standard etc. Requerir simplement ce protocole revient 
alors a ne rien installer du tout dans la plupart des cas, car bien rares sont les 
entreprises sans reseau interne, messagerie ni partage de fichiers. Louverture 
d'une application sur le monde exterieur est une absolue necessite et qui peut se 
targuer de savoir de quoi demain sera fait ? C'est pour cela qu'adopter une 
couche de presentation des donnees de ce type, permet eventuellement de con- 
server notre logique serveur tout en optant pour un autre type de client (pages 
HTML, client Delphi ou VB, etc.). 
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Objets metier - couche de persistance : EJB 

Utiliser des objets codes en Java (ou dans tout autre langage objet) pour repre- 
senter des donnees stockees dans une base relationnelle fait fatalement appa- 
raitre le besoin de transformer ces objets afin de les stacker ou de les lire. 

L'application ne necessite pas tout l'eventail des technologies proposees par les 
specifications des EJB mais BlueWeb desire utiliser cette technologie sur un 
petit projet avant de la mettre en oeuvre sur des projets plus ambitieux. On utili- 
sera done des beans de type session (stateless) et des beans de type entities 
(CMP). 

L'usage des EJB n'est pas indispensable pour notre application mais permet de se 
familiariser avec la technologie, de poser des methodes de developpement et aussi 
de les tester grandeur nature. D'autres solutions seraient envisageables dans ce 
contexte precis meme si elles presentent toutes differents inconvenients : 

• problemes de portabilite du code produit ; 

• problemes lors de la montee en charge ; 

• pas de syntaxe declarative pour la gestion des transactions. 

Le projet doit permettre de tester differents conteneurs EJB et ne peut done 
reposer sur les specificites de l'un ou l'autre. Le codage des EJB sur ce projet 
devra done tenter de se preserver d'utiliser toute specificite de tel ou tel produit. 
Attention ceci n'est pas innocent car, malgre la norme, tous les vendeurs de pro- 
duits proposent des extensions a celle-ci, rendant du meme coup votre applica- 
tion J2EE liee a un seul produit. II faut done trouver un moyen de prevenir ce 
type de travers et ce moyen existe via l'utilisation d'outils de generation de code 
source et de fichiers de deploiement. 



ALTERNATIVE MVC2 et JDBC 



Une solution souvent utilisee et preservant I'ele- 
gance et done la maintenance du code est l'utilisa- 
tion d'un framework MVC2 (pour Modele vue con- 
troleur). Ce type de framework (Struts, Barracuda) 
permet de creer des applications destinees au Web 
(HTML ou XML) tout en separant strictement les 
responsabilites entre les differents acteurs (ser- 
vlets et JSP). JDBC est le nom de I'API de Sun per- 
mettant I'acces aux bases de donnees. JDBC est 
simple d'emploi, assez puissante et tres souple. 
Cette bibliotheque est souvent le dernier recours 
vous permettant d'assurer la persistance d'un 
bean (la persistance n'est plus alors assuree par le 
conteneur mais par le developpeur, elle est done 
appelee BMP par opposition aux beans entites du 
type CMP). 



PRECISION Specifications EJB 

Les EJB proposent d'autres types de beans (clients 
de files de messages) mais les choix adoptes ici 
sont tout de meme ceux adoptes dans la majorite 
des projets a base d'EJB. En effet, les sessions 
beans statefull sont trap couteux en ressources 
(avantageusement remplaces par des sessions 
HTTP) et la persistance des beans est suffisamment 
complexe pour rebuter la majeure partie des deve- 
loppeurs preferant laisser cette tache au conteneur. 



Les differents types d'EJB 

Les EJB proposent differents types de composants, assurant chacun des 
roles differents. On peut citer les entites {entities beans) dont le role est 
de decrire un enregistrement physique dans une base de donnees ou 
encore les composants de session {session beans) dont le role est de 
fournir des services de haut niveau. On pourrait par exemple imaginer 
un bean session Cestionnai reCompte proposant un service 
crediteComptef). Cette methode manipulerait differents objets phy- 
siques de la base (done differentes entites). Les beans sessions peuvent 
avoir un etat ou non. lis seront alors dits statefull ou stateless. Les 
beans entites peuvent etre codes a la main (en JDBC) pour assurer la 
persistance, ils sont alors dits BMP (Bean Managed Persistence), ou 
cette persistence peut-etre confiee au conteneur en realisant ainsi des 
beans CMP (Container Managed Persistence). Enfin, un autre type de 
composant est dorenavant disponible (depuis la version 2.0 des specifi- 
cations EJB) : les clients de files de messages. Le but de ces composants 



est alors de pouvoir s'abonner a une file de messages et de recevoir de 
maniere asynchrone les notifications de nouveaux messages disponi- 
bles dans la queue. Une presentation un peu moins rapide des EJB est 
faite au chapitre 5. II faut s'attarder un peu sur le role preponderant du 
conteneur, qui est un receptacle de hauts niveaux pouvant fournir de 
multiples services a nos objets. Par exemple, e'est lui qui va assurer 
I'activation/passivation de nos objets. En effet, les objets au sein d'un 
conteneur EJB ont un cycle de vie assez complexe et ce, afin d'eviter des 
instanciations (creations) couteuses en performance. Le conteneur four- 
nit des caches d'objets de diverses natures permettant de ne pas avoir a 
creer sans cesse des objets a chaque appel de methode. Cette strategie 
permet aussi de ne pas avoir a s'occuper de la gestion des problemes 
de concurrence entre requetes. L'ouvrage de Richard Monson Haefel 
chez O'Reilly : Enterprise Java Beans, devrait vous permettre de creuser 
ce sujet passionant mais complexe. 
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3 Les doclets ont ete introduits avec le JDK 1.2 et 
"S proposent un moyen simple d'enrichir et de per- 
il sonnaliser la facpn de generer la documentation 
<3 accompagnant le code Java. 



OUTIL XDoclet 

D'une licence on ne peut plus ouverte, simple 
d'emploi, tres facile a interfacer avec Ant, cet outil 
est le candidat ideal pour etre notre garde-fou, il 
nous permet de conserver notre liberte vis-a-vis du 
conteneur. 

► http://xdoclet.sourceforge.net/ 



Ces outils parmi lesquels on peut citer EJBGen ou XDoclet permettent de 
generer tout le materiel necessaire au deploiement des EJB via l'ecriture des 
simples classes d'implementation. Bien entendu, l'ecriture de ces classes suppose 
l'enrichissement du code source Java traditionnel de labels (tags) Javadoc speci- 
fiques via des doclets. 



Client riche - SWT 

Avant d'en dire plus sur la nature de ce type d'interfaces, on peut commencer 
par les opposer aux clients dits legers, a savoir de simples pages HTML affi- 
chees dans un butineur web. Ces dernieres disposent de nombreux avantages, 
entre autres : 

• aucune installation n'est necessaire sur le poste client (il y a toujours un navi- 
gateur web) ; 

• elles sont tres legeres pendant l'execution ; 

• elles sont tres simples a realiser, puisque de nombreux outils sont disponibles 
et ce depuis de nombreuses annees (DreamWeaver par exemple) ; 

• tres bien standardisees si Ton se limite a de l'HTML en version 3.2. 

L'appellation « client riche » en revanche implique des interfaces complexes et 
evolutives, basees sur des composants reutilisables. II s'agit de proposer a l'utili- 
sateur des interfaces ergonomiques disposant de fonctionnalites de haut niveau 
(impression, aide en ligne et aides contextuelles). De plus, l'utilisateur doit pou- 
voir compter sur une interface assez intelligente pour s'assurer de la validite de 
ses saisies. 

L'utilisation de composants evolues du type listes et autres arbres ou tables 
permet d'obtenir des interfaces beaucoup plus riches fonctionnellement que de 
simples pages HTML. 

La simplicite de deploiement (un navigateur est toujours instable sur un PC de 
bureau) est l'avantage majeur de ces interfaces clientes. La richesse des inter- 
faces possibles avec des clients dits « lourds » vient contrebalancer cet avantage. 



POLEMIQUE Langages de script et DHTML 

L'apparition du JavaScript, VBScript et du DHTML ont rendu possible des pages HTML proposant 
des combo, listes et autres composants (widgets), mais ceci en sacrifiant la portability du code 
(le code JavaScript n'est pas interprets de la meme facon sur tous les navigateurs) et la reutilisa- 
tion/maintenance puisque ce code s'avere cauchemardesque a faire evoluer. Ceci explique le 
choix d'une couche cliente plus lourde mais portable et axee sur l'utilisation de composants reu- 
tilisables. Certaines alternatives existent mais leur aspect confidentiel est une entrave reelle a 
leur utilisation dans des projets de grande envergure. En effet, les clients n'aiment pas les prises 
de risque trap importantes ce qui doit dissuader quiconque de leur proposition utilisant de telles 
solutions. 
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La problematique liee au choix tourne ici au dilemme en raison des besoins et 
imperatifs suivants : 

• code portable ; 

• code reutilisable ; 

• puissance des composants ; 

• interface legere (peu couteuse en ressources memoire et CPU). 
La bibliotheque SWT et le projet Eclipse 

Le projet Eclipse (initie par IBM) a engendre la creation d'une bibliotheque (en 
anglais toolkit) graphique portable Java reposant sur des composants natifs au 
systeme. Ce projet ambitieux nous permet dorenavant d'avoir a notre disposi- 
tion une alternative serieuse a la bibliotheque Swing cote client. SWT est cette 
bibliotheque et va etre utilisee afin d'obeir a une des contraintes liees au poste 
client : processeur standard (PII 450 MHz) et 128 Mo de RAM. Dans de telles 
conditions, la majeure partie des applications Swing ne peut etre executee tout 
en gardant un rafraichissement convenable. La page principale du projet Eclipse 
est disponible a l'adresse suivante : http://www.eclipse.org. Eclipse est un environne- 
ment de developpement (IDE) tres souple et modulaire, ce qui le rend extreme- 
ment populaire. De plus, sa conception unique le rend tres bien adapte a tous 
types d'utilisations, meme eloignees du developpement. Nous aurons l'occasion 
d'en dire plus sur ce projet un peu plus tard. Concentrons-nous sur SWT, ce 
toolkit graphique nous permettant de relever le defi des clients riches. 

RAPPEL Swing 

Depuis la sortie du JDK 1.2, Java inclut une API robuste et puissante utilisable pour la creation 
d'interfaces graphiques (IHM ou GUI en anglais). Cette bibliotheque est actuellement mure en 
matiere de fonctionnalites et de stabilite des API mais pose toutefois le probleme des performan- 
ces. La question des performances reelles de Swing est un sujet epineux et sans trop s'engager, 
on peut constater qu'il est tres difficile d'obtenir un comportement correct sur de petites machi- 
nes avec une bibliotheque comme swing. En revanche, en tant que premiere arrivee sur le mar- 
che, Swing est la reference en la matiere, elle beneficie ainsi de nombreuses bibliotheques com- 
plementaires permettant de simplifier I'impression (qui est une des grosses faiblesses historiques 
de I'API) ou d'ajouter de nouveaux composants (calendriers, gestion de graphes, etc.). Le choix 
n'est done pas entierement innocent car si on n'adopte pas Swing, on renonce a JavaHelp (aide 
enligne)aQuestJCIassetautresproduitsdequalite. 



POLEMIQUE Quelle technologie choisir ? SWT et XUL 

De nombreuses possibility s'offrent a nous, alors pourquoi choisir SWT qui semble etre le 
challenger ? Quelles autres possibility seraient aussi envisageables ? Si la premiere question 
trouve une reponse dans la liste des criteres de choix enoncee precedemment, la seconde merite 
une legere digression. Si Swing est la reference, SWT le challenger, XUL pourrait etre le trouble- 
fete. En effet, XUL est issu du projet Mozilla et permet de generer des interfaces graphiques 
dynamiquement moyennant un descriptif XML. Malheureusement, XUL n'est pas destine a gene- 
rer du code Java et le projet JXUL visant a le faire semble abandonne. Dommage... A noter tou- 
tefois que XUL s'inscrit dans la lignee d'un autre projet Open Source : Glade, developpe pour le 
projet Gnome (environnement graphique destine a Linux et autres Unix). 




OUTILS Quest JCIass 

* www.quest.com/jclass/ 
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Le display est une notion propre a SWT, c'est le ► 
composant commun aux applications, qu'elles 
soient graphiques ou en ligne de commande, 
necessitant I'affichage d'informations. 



Le shell joue le role d'un frame ou un Jframe en ► 
AWT/Swing. 



On cree ici un layout, dont le type est propre a ► 
SWT (un des layouts disponibles en SWT 2.0), 
mais la notion est exactement la meme que celle 
qui vous est surement familiere avec AWT/ 
Swing. 

Definit ce layout comme gestionnaire de place- ► 
ments d'objets pour le shell precedemment 
cree... 

Un widget SWT est toujours construit a partir ► 
d'un composite parent. Ici le composite est le 
shell... On remarquera aussi un parametre 
SWT.NULL permettant de modifier le style du 
composant cree. (voir API SWT pour plus de 
details). 

Remarquez les similitudes entre les methodes ► 
disponibles sur les differents composants. C'est 
un aspect assez agreable du codage en SWT 
engendre par la remarquable hierarchie de clas- 
ses. 



Le morceau de code suivant donne a titre indicatif (sans rapport avec notre 
application), montre un exemple simple d'utilisation de SWT. 

import org.eclipse.swt.SWT; 
i mport org . eel i pse . swt . 1 ayout . RowLayout ; 
i mport org . eel i pse . swt .wi dgets . Button ; 
i mport org . eel i pse . swt . wi dgets . Di spl ay ; 
import org. eclipse. swt. widgets. Label ; 
import org. eclipse. swt. widgets. Shell ; 

/** 

* ©author jerome 

*/ 

public class HelloWorldSWT { 

public static void main(String[] args) { 
Display display = new DisplayO; 

// associe le shell au display 

Shell shell = new She! 1 (di spl ay) ; 

shell .setTextC'Hello world revisite en SWT"); 

shell .setToolTipText("un tooltip debile"); 

// cree un layout. . . 

// le positionne en mode auto wrapping.. 
RowLayout layout = new RowLayout (); 
1 ayout. wrap=t rue; 

// associe le layout au shell 
shell .setLayout (layout) ; 

// cree les widgets 

Label label = new Label (shell, SWT.NULL); 



label .setText("Coucou monde"); 

Button button = new Button(shell .SWT.NULL) ; 

button. setText("Cliquez moi"); 

button. setToolTipText("Si vous n'avez rien a faire.."); 
Button button2 = new Button (shell , SWT. PUSH) ; 
button2.setText("Un autre bouton sans but"); 
button2.setToolTipText("Si vous n'avez rien a faire.."); 
// calcule la taille optimale 
shell .pack() ; 
// ouvre le shell 
shell .open() ; 

// attend la fermeture pour liberer les ressources 
// graphiques 

while (! shell .isDisposedO) { 

if (! display. readAndDispatch()) display.sleepO ; 

} 

} 

} 
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Si SWT est issue du projet Eclipse, l'utilisation de cette bibliotheque n'implique 
en rien l'utilisation d'Eclipse. L'utilisation d'un jar contenant le code Java com- 
pile de SWT et d'une bibliotheque C compilee pour la plate-forme (DLL sous 
Windows) suffit a mettre a disposition la bibliotheque. Afin de clarifier l'appa- 
rente symbiose SWT/Eclipse, la gestion des signets ne va pas se faire en tant 
que plug-in Eclipse (meme si on aurait pu l'imaginer) mais bel et bien en tant 
qu'application a part entiere (stand alone) et SWT n'est alors qu'une biblio- 
theque Java comme les autres (peu de difference avec un parseur XML ou une 
bibliotheque orientee reseau). 



Deploiement 

Le deploiement de l'application doit etre le plus simple possible (maintenance 
aisee), reposer ainsi sur une technologie permettant : 

• une gestion des mises a jour logicielles ; 

• une installation simple sur le poste client ; 

• une installation simple sur le serveur ; 

• l'economie de la bande passante reseau grace a la gestion de caches sur le 
poste client. 

OUTIL Java Web Start 

Sun propose depuis quelques mois une solution tres interessante quant au deploiement dupli- 
cations a travers Internet (intranet) : Java Web Start. Ce produit livre en standard avec le JDK 1 .4 
permet de gerer des deploiements d'applications Java sur un reseau (LAN ou WAN) en offrant 
une installation sur le poste client reduite au strict minimum (done simple) et une installation 
serveur triviale (un MIME type a ajouter a la liste de ceux geres par votre serveur web). 
► http://java.sun.com/products/javawebstart/ 



//, Jar (Java ARchive) 

Format d'archive proche du format zip. II permet de 
packager des classes Java de maniere a les distri- 
buer efficacement. Le format Jar apporte des fonc- 
tionnalites de signature, versioning (gestion des 
versions) et packaging via un manifeste. Bien 
entendu le JDK fournit un utilitaire (jar) permettant 
de creer ou d'extraire de tels fichiers. On peut noter 
que sa syntaxe est proche de I'outil Unix : tar. 



//, Plug-in 

II s'agit d'un ensemble de classes permettant 
d'etendre les fonctionnalites d'un systeme 
existant. Cela sous-entend que ce systeme a 
ete pense dans cette optique et qu'il a mis en 
oeuvre une architecture assez ouverte pour 
accueillir a la volee de nouveaux composants. 
Un bel exemple d'une telle architecture est 
I'editeur de texte de Romain Guy : Jext. 



A Parseur 

Ce terme designe un outil permettant 
d'extraire de I'information dans un fichier 
structure suivant une grammaire donnee. II est 
issu du vocabulaire lie a la theorie de la compi- 
lation dont le contexte depasse largement le 
cadre de cet ouvrage. 
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Base de donnees 



Comment stacker nos donnees ? Dans une base de donnees relationnelle. Pour- 
quoi ce choix ? Car meme si des solutions telles que des fichiers texte peuvent 
etre envisagees, elles n'ont rien de professionnel dans le sens ou elles n'offrent 
aucun des avantages d'une base de donnees comme : 

• securite dans les acces (les moteurs de base de donnees peuvent gerer des 
droits applicatifs) ; 

• securite dans les traitements (un bon moteur de base de donnees doit sup- 
porter les transactions) ; 

• pas d'ecriture de code specifique a la base puisqu'on utilise un langage de 
requetes standard (SQL), alors que l'utilisation d'un fichier texte requiert 
l'ecriture de code (parsing) necessaire a la lecture/ecriture des donnees ; 

• vitesse des traitements et puissance des requetes (les moteurs de base de 
donnees sont optimises pour entrainer des couts minimes) ; 

• puissance et facilite d'administration. 

Le seul avantage d'une solution a base de fichiers est alors sa simplicite de mise 
en ceuvre et 1' absence d'administration mais cela ne pese pas lourd dans la 
balance... 

Notre application ne devra pas reposer sur des specificites de telle ou telle base 
de donnees et done ne reclamera qu'une compatibilite avec la norme ANSI 
SQL 92 nous assurant la disponibilite d'un driver JDBC. 

Ceci permet d'ouvrir le choix sur une tres vaste gamme de produits, pour n'en 
citer que quelques-uns : 

• MySQL; 

• Postgres ; 

• Oracle ; 

• DB2; 

• Sybase. 

Bien evidemment cette compatibilite exclut formellement Microsoft Access. En 
effet, Access n'est pas un produit conforme aux normes ANSI SQL. 

ATTENTION MySQL 

Ce produit dispose de la majeure partie des fonctionnalites attendues d'un moteur de base de 
donnees (support du SQL ANSI 92, triggers) mais la recente introduction des transactions dans le 
produit en fait une fonctionnalite encore un peu experimental.. . 



En resume 



En optant pour une architecture a 5 couches, Blueweb applique le principe 
« d'abstraire pour maintenir » et joue la carte de la stabilite et de l'evolutivite. Le 
projet etant plus un pretexte qu'une application critique, l'equipe choisit de 
miser sur des technologies emergentes. De plus, en tant que projet pilote, 
l'application a pour vocation d'etre la plus formatrice possible pour l'equipe en 
charge de sa realisation. La part de risque reste mince, puisque les EJB sont une 
technologie arrivant a phase de maturation et que SWT/Jface trouve en Eclipse 
la parfaite illustration de sa mise en pratique. 

Larchitecture 5 couches proposee pour ce projet test est une architecture souple 
permettant de repondre a tous types de contraintes (deploiement des 5 couches 
sur une seule machine, un PC portable utilise pour des demonstrations par 
exemple) comme un deploiement integrant repartition de charge {load balan- 
cing) ou clustering avec une machine hote pour la base de donnees et un serveur 
d'applications tournant sur plusieurs machines virtuelles pour de tres grosses 
montees en charge. En bref, essayant d'eclaircir ce jargon d'informaticiens, 
l'architecture retenue est celle qui nous permet de repondre a une large gamme 
de besoins allant de la demonstration (done facilite d'installation et utilisation) 
jusqu'aux applications de tres hautes performance et disponibilite (applications 
cruciales pour une entreprise en rapport avec des chaines de production par 
exemple). De plus, elle est propice a une reelle utilisation des composants en 
limitant au possible les couplages entre les diverses couches. 
Enfin, on peut citer comme significative la position de leader tenue par Apache 
sur le marche des serveurs web ou la qualite d'un produit comme Samba. Un 
pragmatisme elementaire fera se poser la question : pourquoi payer quand on peut 
avoir un equivalent gratuit ? Pourquoi s'enfermer quand on peut avoir la liberte ? 



//. Load-balancing 

Ce terme anglais peut se traduire par repartition 
de la charge et designe la preoccupation pour cer- 
taines applications critiques (done tres chargees) 
de repartir le nombre de requetes a traiter sur plu- 
sieurs machines, ce afin de garder des temps de 
reponse acceptables. 



//, Clustering 

Ce terme anglais est traduit classiquement en fran- 
cais par le concept de grappes de machines. II 
s'agit en fait d'une facpn artificielle de faire d'un 
groupe de machines (la grappe) une seule aux 
yeux du reste des machines du reseau. Ceci a 
I'avantage de creer des machines d'une puissance 
monstrueuse a partir de nombreuses petites 
machines tout en rendant tres stable I'applicatif 
lance sur cette machine artificielle, puisqu'il est 
peu probable que toutes les machines tombent en 
panne en meme temps. C'est une maniere sedui- 
sante pour traiter a la fois les problemes de mon- 
tee en charge de certaines applications (on multi- 
ple les ressources memoire et le nombre de 
processeurs) et la disponibilite des applications 
(permet theoriquement d'aboutir a une disponibi- 
lite de 100% a moindres frais). 
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Environnement de 
developpement CVS et Ant 



Le travail en equipe, le respect de chartes de developpement, 
les outils de gestion de projet sont autant de points constituant 
un environnement de developpement. La methodologie 
utilisee, elle aussi, influe sur la facon de travailler et done sur 
les structures et procedures a mettre en place. Les outils 
exposes par la suite sont la base du travail en equipe et visent a 
former un ensemble coherent et facilitant la productivite. 



SOMMAIRE 

► Gestion du code source avec 
CVS 

► Configuration de Ant 

► Personnalisation de Ant 

► Les produits du projet 
Commons 

MOTS-CLES 

► CVS 

► Ant 

► task 

► build-file/makefile 

► ligne de commandes 

► client HTTP 

► collections et types primitifs 



OUTIL CVS 

CVS est lui aussi un produit Open Source, qui pos- 
sede des antecedents tels que la question de son 
adequation avec les besoins de BlueWeb ne se 
pose pas. C'est la Rolls des outils de gestion de 
configuration, car il est gratuit, performant, stable 
et relativement simple a installer. De plus, son 
adminsitration est reduite au minimum. Utiliser ce 
produit, c'est choisir en toute serenite une valeur 
sure. On peut rappeler a titre anecdotique que des 
projets tels que le noyau Linux, le serveur web 
Apache et bien d'autres sont geres et developpes 
par des centaines de developpeurs sur la planete 
en utilisant cetoutil. 
► http://www.cvshome.org/ 



REFERENCE Subversion 

Ce produit est disponible sur la page suivante : 
http://subversion.tigris.org/. Subversion est un pro- 
duit deja tres mur ; il ne lui manque plus qu'un peu 
de temps de maniere a ce qu'il soit integre dans 
des outils de developpement comme Eclipse ou 
Ant. 



ALTERNATIVES Continuus et ClearCase 

Ces deux produits sont surement les plus aboutis 
en la matiere, seulement leur cout (prix de la 
licence) et le niveau de formation requis avant uti- 
lisation reservent leur utilisation a des entreprises 
fortunees. Par ailleurs, il faut signaler qu'il est 
necessaire de dedier environ 1 personne sur 
10 developpeurs pour la seule administration de 
ces produits, ce qui a evidemment un cout non 
negligeable (quand il est possible de I'envisager). 



ALLER PLUS LOIN Pourquoi une machine de 
production ? 

II est indispensable de passer outre les problemes 
de classpath et de faire en sorte que les livra- 
bles (classes Java ou fichiers Java) se comportent 
correctement dans un environnement « sain ». 
C'est pour cela qu'une machine doit etre dediee a 
la production et que celle-ci ne peut se faire sur le 
poste de I'un des developpeurs du projet. La seule 
contrainte est d'avoir une JVM installee et un Ant 
proprement configure, puis de lancer I'execution 
du makefile... 



Le tableau suivant plante le decor commente dans la suite de ce chapitre. La 
justification du choix du serveur d'applications ayant ete faite precedemment, 
on se concentrera sur les autres facettes des choix par la suite. 



Gestionnaire de code 

cvs~ 



Outil de make 

Ant 



Serveur d'applications 



Ensemble integre Jboss + 
Tomcat 



Gestionnaire de code source : CVS 

Depuis de nombreuses annees, BlueWeb utilise CVS comme outil de gestion 
des sources et de controle de versions, done ce nouveau projet va naturellement 
se voir offrir son espace reserve sur le serveur CVS. 

Les developpeurs auront l'esprit libre pour travailler, un outil eprouve se char- 
gera de pallier d eventuelles « betises » rendant toujours possible le retour en 
arriere vers une version precedente, tandis que le responsable qualite aura tou- 
jours la possibilite de restaurer un environnement « labellise ». La gratuite de 
l'outil nous amene a nous demander pourquoi s'en priver... On peut noter que 
tout autre gestionnaire de code source (Microsoft Visual Source Safe, Rational 
Clearcase, Continuus, etc.) aurait pu etre utilise. CVS est utilise avec Ant, 
notamment au chapitre 7 consacre a l'audit du code. Le grand rival libre de 
CVS, Subversion, est desormais a l'etat de production. Ce projet est concu de 
maniere a ressembler le plus possible a CVS tout en gommant les quelques 
defauts connus de ce venerable ancetre. 



Production des versions : Ant 

Le responsable qualite du projet, Michel, alarme par ses lectures, tient a etre le 
plus detache possible des outils de production fournis avec les environnements 
de developpement et a pouvoir utiliser la puissance d'une machine neutre pour 
proceder a des builds nocturnes. 

II decide done d'utiliser sa machine comme machine de reference, pour lancer 
des taches repetitives durant la nuit. Linstallation est minime (un JRE + Ins- 
tallation de Ant et quelques bibliotheques), ne coute pas cher a la societe, ne le 
perturbe pas durant son travail (car Michel dort la nuit...) et doit permettre de 
deceler tres vite differents problemes (problemes de compilation, de tests uni- 
taires non conformes, qualite). Bien entendu, cet outil sera utilise avec le serveur 
de fichiers sources (CVS), afin de produire a la demande une version labellisee 
ou encore operer de la mise en forme sur tout le contenu du referentiel de 
sources. 
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En fait, au niveau du choix de cet outil, BlueWeb n'a guere d'alternatives, car si 
tous les environnements de developpement du marche (JBuilder, Forte, Net- 
beans, Eclipse, etc.) proposent des fonctions de compilation des sources (ainsi 
qu'une interaction avec les referentiels de code source), ils se revelent insuffi- 
sants car ils ne couvrent qu'une faible partie des besoins en matiere de produc- 
tion des versions : 

• interaction avec le serveur CVS ; 

• compilation du code ; 

• packaging (creation d'archives au format jar, etc.) ; 

• execution des tests unitaires ; 

• generation de documentation ; 

• instrumentation des fichiers sources (c'est-a-dire transformation de ceux-ci 
par l'intervention d'un outil) ; 

• integration d'outils tiers (generation automatique de code, d'indicateurs). 

Bref, la concurrence sur ce marche est tres limitee et Ant s'avere etre l'outil stan- 
dard dans le monde Java, meme si Ton doit reconnaitre que les utilisateurs de 
l'outil Unix make doivent pouvoir arriver aux memes fonctionnalites. 



Continuous integration 



Cette expression provient du jargon du mouve- 
ment lie a I'Extreme Programming et notamment 
aux idees « d'integration perpetuelle » (pour conti- 
nuous integration dans le vocabulaire original 
anglais). Les buts sont multiples mais ils permet- 
tent surtout de : 

• tester le code entrepose dans le serveur CVS ; 

• generer des versions du produit sans interven- 
tion humaine ; 

• appliquer divers outils sur I'ensemble des sour- 
ces du projet de maniere a traquer des bogues 
de non-regression (tests unitaires) et tester la 
conformite du code avec la charte de codage 
interne. 



De ('utilisation de la variable CLASSPATH 

L'aparte dedie aux machines de production permet d'aborder un probleme epineux lie au deve- 
loppement en Java : I'utilisation de la variable d'environnement CLASSPATH. Cette variable a 
pour role de delimiter au sein d'une variable toutes les bibliotheques (. zi p ou . jar) et tous 
les chemins d'acces aux fichiers . cl ass. Une mauvaise maitrise de cette variable entraine de 
nombreuses questions sur les forums, mais le risque le plus grand provient d'une maitrise par- 
tielle des concepts lies a cette variable. En effet, vous ne devez jamais supposer quoi que ce soit 
sur le « CLASSPATH » de la machine sur laquelle s'execute votre application. II vous revient de 
packager votre application correctement pour qu'elle puisse etre autonome et surtout sans con- 
sequence pour I'environnement de votre client. Pour cela, Ant ou un script (shell sous Unix ou 
batch sous DOS) serontvos meilleures armes. Un bon programmeur Java n'utilise pas la variable 
d-environnement CLASSPATH I 



Ant - Vocabulaire de base 



La comprehension de l'outil necessite seulement deux mots, meme si la maitrise 
reelle du produit reclame un peu plus de travail, mais le jeu en vaut la chan- 
delle... 

• Task (tache) : une tache est au sein d'un makefile l'equivalent d'une instruc- 
tion dans un langage de programmation, c'est-a-dire un objet servant a 
accomplir une fonction bien specifique sur eventuellement un certain nom- 
bre de parametres d'entree (nom du repertoire contenant les classes) et 
entrainant un certain resultat (fichier . jar). Par exemple, la tache copy per- 
met de copier un fichier (ou un ensemble de fichiers), la tache jar permet de 
creer un fichier jar, etc. 



RAPPEL Ant 



Ant est un outil de make, c'est-a-dire d'abord des- 
tine a gerer la compilation de code source Java et 
la production de fichiers .class {bytecode). Cet 
outil est entierement ecrit en Java et utilise des 
makefile XML (fichiers build, xml ). 
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Creation d'un projet denomme « Petit Projet » 
dont le repertoire de base (basedi r) est le 
repertoire courant (.) et la cible par defaut 
(def aul t) est compi 1 e. 



src va designer le repertoire ou seront stockes 
les fichiers sources. De meme, build designe le 
repertoire cree par la compilation. 



Ici, on peut noter I'utilisation de I'attribut 
description permettant de renseigner un 
utilisateur de I'utilite d'une cible. Remarquez que 
ce message n'est affiche que quand I'utilisateur 
desire en savoir plus sur votre processus de 
construction, c'est-a-dire en tapant 
ant -projecthel p. 



• Target (cible) : une target est un point d'entree dans un makefile (done 
caracterise par son nom : bui Id, doc, all) et vise a accomplir une des etapes 
d'un processus de production. 

Par exemple, on pourrait decider de creer un makefile compliant les sources et 
d'appeler cette etape du processus global de production par compile. Une autre 
etape pourrait etre la destruction du resultat d'une compilation appelee clean. 
Notons qu'un projet contient des cibles {targets) faisant appel a differentes 
taches eventuellement interdependantes. Vbici ci-dessous un exemple de make- 
file pouvant repondre a ce besoin. 



Exemple de makefile 
<project name="Petit Projet" default="compile" basedir="."> 



<!-- ici on positionne des valeurs pour ce build --> 

<!-- d'une maniere tres originale on indique que ${src} va 
representer le directory src --> 

<property name="src" location="src"/> 

<property name="build" location="build"/> 

<!-- cette cible realise l'init de notre build-file --> 

<!-- ici reduite a cree le repertoire pointe par la variable 
${build} (valeur build d'apres V initialisation precedente --> 
<target name="init"> 
<!- creee le repertoire ${build} --> 
<mkdir dir="${build}"/> 
</target> 

<! — cette cible compile le code source — > 
<target name="compile" depends="init" 

description="compile le code source requiert 1 'execution 
de la tache init " > 
<!-- Compile le code contenu dans: ${src} en deposant les classes 
dans : ${build} --> 
<javac srcdir="${src}" destdi r="${build}"/> 
</target> 

<! — un peu de menage pouvant etre utile, cette cible detruit le 
repertoire ${build} --> 

<!-- done pour etre sur de reparti r de zero il faudra l'invoquer 
via un: ant clean --> 
<target name="clean" 

description="detruit le repertoire de build" > 
<!-- Detruit le repertoire ${build} --> 
<delete di r="${bui ld}"/> 
</target> 
</project> 
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Adapter Ant a ses besoins 



L'objet de ce livre n'est pas d'aborder Ant de maniere exhaustive (est-ce 
possible ?). On ne tient pas a evoquer toutes les taches predefinies {built-in tasks) 
et encore moins a evoquer tous les contextes d'utilisation possibles, mais etant 
donne 1'importance de l'outil au sein de l'ouvrage, il est necessaire de s'attarder un 
peu sur quelques specificites de ce produit qui le rendent aussi particulier. 

Taches utilisateurs (Custom Tasks) 

Ant est un outil pouvant etre etendu a l'infini et adapte a vos besoins particuliers 
et ce, tres simplement. 

Pour ce faire, chaque besoin propre doit etre exprime sous forme d'une nouvelle 
tache dite custom task. 

Avant, seul le codage des taches en Java etait disponible ; depuis la version 1.5, 
Ant vous permet dorenavant de coder vos taches via deux types de langages : 

* Java; 

• un langage de script respectant la norme BSF (pour Bean Scripting Fra- 
mework) d'IBM. 

Codage en Java d'une tache utilisateur 

Pour un premier exemple de codage d'une tache Ant, nous n'allons pas nous 
lancer dans un developpement important. Nous implementerons une tache de 
Ant : la tache Echo. Celle-ci redirige vers la console (l'ecouteur par defaut) le 
message donne en entree. 

Principe de codage : convention JavaBean 

Tres simple a coder, une custom task ne reclame qu'une correspondance entre les 
attributs specifies dans le fichier XML pour l'appel de cette tache avec des attri- 
buts d'instance de la classe Java. 

Chaque attribut de votre classe personnalisee doit etre prive et doit mettre a dis- 
position une methode setXXX permettant de positionner la valeur de l'attribut 
XXX. C'est une facon de coder tres proche des conventions regissant les Java- 
Beans (plus simple). 

Une seule contrainte : votre classe doit heriter de la classe org . apache . tool s . 
ant .Task. 

Enfin, le code correspondant a l'execution de votre tache doit etre place dans 
une methode publique execute (). 



REMARQUE Ce livre et les scripts 

Nous ne nous interesserons qu'a la maniere classi- 
que de coder une custom task en Java, ceci en rai- 
son du nombre de langages de script possibles 
(BeanShell, Rhino...) et afin que le code demeure 
portable (il ne necessite pas I'installation de la der- 
niere version de Ant). 
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On place notre classe dans un paquetage specifi- 
que... 



Voici les imports requis par cette classe. Ici, on 
s'attache a la classe Task du paquetage 
org . apache . tool s . ant. Notez aussi qu'il 
est de bon gout d'attraper les exceptions du type 
Bui 1 dExcepti on et d'en lever de nouvelles 
en cas de probleme. 



Surtout bien remarquer la convention JavaBean 
utilisee lors du codage des taches Ant. Un attri- 
but, renseigne lors de I'appel dans le fichier XML 
(build. xml) se verra associer des methodes, dites 
accesseurs. 



Ici quoi de plus simple qu'un simple appel a 
System. out. println(). Neanmoins, le 
code place dans cette methode peut etre aussi 
complexe que necessaire. Pour des exemples de 
taches utiles, n'hesitez pas a consulter le code 
source des taches Ant, il est la pour cela. 



Une tache Ant tres simple 

package com. blueweb. tasks; 

import org. apache. tools. ant. Task; 

i mport org . apache . tool s . ant . Bui 1 dExcepti on ; 

/** 

* Une classe singeant la task Echo (built in task de Ant) 

* Elle n'a pas d'autre pretention que de donner un exemple 

* simple de programmation d'une custom task Ant 

* ©author J.MOLIERE - 2002 

V 

public class SimpleEcho extends Task{ 

// attribut d'instance 

// c'est le message qui va etre affiche 
private String echoMessage = ""; 



/* 



V 



V 



* Cette methode est un « setter » pour 1 'attribut echoMessage. Ell 

* permet de positionner la valeur du message a afficher. 

* Remarquez bien la casse dans le nom de la methode 

public void setEchoMessage(String aMessage){ 

echoMessage = aMessage; 
} // setEchoMessageO 

/** 

* c'est ici que l'on place le code devant 

* etre execute lors de chaque appel de la task 

* dans notre cas un simple System. out. println 

* ©exception Bui IdException , si quelque chose se passe mal . . . 

public void execute() throws BuildException{ 

+ echoMessage ) ; 



System. out. println(" — > 
} // executeO 

} 



Appel de la tache SimpleEcho 



Ce projet a pour nom BlueWeb, tres original 
n'est-ce pas ? La cible par defaut s'appelle 
def aul t ce qui la encore est tres original. 



Chaque tache exterieure a Ant doit etre declaree 
de cette facpn. Ici on presuppose que le fichier 
. cl ass correspondant a cette classe se trouve 
dans votre CLASSPATH. C'est une chose qu'il 
faut eviter de presupposer, mais qui permet dans 
notre cas de se concentrer sur I'essentiel. 



Une fois la tache definie, on peut maintenant 
I'invoquer depuis notre cible principale. 



<! — Simple build file --> 

<!-- pas de construction de jar ou de classes --> 

<! — juste un appel a notre custom task SimpleEcho — > 
<project name="BlueWeb" default="default"> 

<!-- le tag taskdef permet d'associer un nom a une classe Java de 
votre classpath --> 

<!-- ici notre tache s'appellera bluewebecho --> 

<taskdef name="bluewebecho" 

cl assname="com . bl ueweb . tasks . Simpl eEcho"/> 

<target name="default"> 



<bluewebecho echoMessage="Bonjour Monde"/> 

</target> 
</project> 
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Le build-file Ant et I'approche qualite 



Ant : le couteau Suisse du developpement Java ? 

Maintenant que sont posees les briques, commencons a monter les murs... 

Pour ses qualit.es d'outil multi-plates-formes, de facilite d'ecriture des regies de 
notre processus de production (la syntaxe XML evite les pieges rebutant le neo- 
phyte face a son premier makefile) et d'extensibilite tres simple, Ant est l'outil 
cle, le fil conducteur et le denominateur commun via lequel nous appliquerons 
differents types de traitements sur notre code source : 

• instrumentation du code source afin de creer du bytecode depuis un fichier 
source Java (comme le fait XDoclet qui, via un fichier d'implementation 
d'un EJB, cree des classes Java et des fichiers de deploiement) ; 

• jeu de tests, lancement des differents tests unitaires et redaction d'un rap- 
port, ce qui permet de prevenir les bogues dits de non-regression (c'est-a- 
dire des bogues provenant suite a des modifications de code source 
operationnel) ; 

• controle qualite du code source, via lancement d'une tache nommee 
checkstyl e permettant de signaler des anomalies dans le respect des char- 
tes de nommage ; 

• application des contraintes de deploiement et d'architecture (voir chapitre 6 
sur le deploiement pour un exemple de custom task permettant de deployer 
notre application via Java Web Start ). 

Notre build file va done contenir des processus tout a fait differents puisqu'ils 
n'impliquent pas les memes acteurs : 

• Le chef de projet et le responsable qualite s'attacheront a faire respecter a la 
fois les conventions de codage adoptees en interne et la methodologie de 
developpement {Extreme Programming}). lis seront exigeants quant a la 
fourniture de jeux de tests et au bon deroulement de ceux-ci au sein d'une 
suite de tests. 

• Le responsable du deploiement cherchera a produire une version conforme 
aux specifications et aux contraintes du projet. 

• Les codeurs de la partie serveur utiliseront le makefile avant toute produc- 
tion de maniere a deployer au sein de leur serveur d'applications leurs com- 
posants (servlets/EJB). 



B.A.-BA Build-file 



Ce terme designe le nom donne dans le vocabu- 
laire Ant au fichier XML decrivant les etapes cons- 
tituant le cycle de production d'une version d'une 
application. Un fichier de ce type aura done diffe- 
rentes parties couvrant compilation, creation 
d'archives, etc. 



PRECISION Reutilisation 



II n'est pas indispensable de tout reinventer et 
d'adopter des normes a I'oppose de ce qui se fait 
dans le petit monde Java. . . N'hesitez surtout pas a 
reutiliser et a vous inspirer des differents grands 
projets Open Source : JBoss, Jakarta, etc. 



Choix des bibliotheques 



Toute application reclame un certain nombre de services standards (logs, parsing 
XML, serialisation Java <-» XML, etc.). Lapproche objet, poussant a factoriser 
tout ce qui peut l'etre et a reutiliser tout ce qui l'est, rend inadmissible le fait de 



//. Factoriser 



Ce terme est important, il est done preferable de 
I'utiliser plutot que de le contourner. II designe le 
fait de regrouper, de conserver en un seul endroit 
des donnees relatives a un sujet. Ce terme vient 
tout droit du jargon mathematique. II relate une 
preoccupation constante du monde de I'entreprise. 
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POLEMIQUE La licence GPL 

Pour de plus amples informations sur cette licence 
logicielle, se reporter au site web www.gnu.org. 
Cette licence est une sorte de cholera juridique 
obligeant tout produit utilisant une composante a 
licence GPL a etre lui-meme sous licence GPL. Ceci 
ne signifie pas que c'est une mauvaise licence, elle 
est seulement tres exigeante... Cette exigence est 
d'ailleurs la raison d'etre d'une licence plus per- 
missive, la LGPL. 
Par exemple : 

► http://mitglied.lycos.de/xmltp/intro.html 

Le JDK 1 .4 comporte desormais sa propre API de 

logging : java. uti 1 . loggi ng 



voir certaines equipes se lancer dans la realisation du enieme framework de ges- 
tion des logs. Reutilisons ! 

Criteres de choix 

Maintenant que le mot reutilisation est acquis, il convient de se fixer des bornes 
cadrant nos choix. Quels sont les criteres ? Quel est leur impact sur votre 
projet ? S'il est impossible de repondre de maniere generique a cette question, 
etant donne que chaque societe a un historique propre, que chaque equipe a des 
sensibilites et des contraintes budgetaires differentes, il est evident que les cri- 
teres suivants vont interesser chacun d'entre nous (sans forcement avoir la meme 
hierarchie d'importance d'un contexte a un autre) : 

• Type de licence de la bibliotheque : GPL ou LGPL, Apache ou BSD, Sun 
ou proprietaire... autant de declinaisons possibles mais la lecture des docu- 
mentations associees a la licence d'une bibliotheque vaut toujours la peine 
requise pour le faire. En effet, imaginez que, pour un navigateur web ecrit en 
Java a but lucratif et a optique proprietaire, BlueWeb choisisse un parseur 
XML a licence GPL... Les licences du type Apache ou BSD sont reelle- 
ment tres permissives, il est done peu probable qu'opter pour une API distri- 
bute en ces termes soit un mauvais choix. 

• Adequation avec les specificites du projet. Pour certaines applications 
(domaine de l'embarque, applets, etc.), le volume occupe en memoire ou en 
espace de stockage (taille du fichier jar) peut etre un critere redhibitoire, eli- 
minant de fait de tres bonnes bibliotheques. C'est pour cela notamment que 
Ton peut trouver des implementations ultra-legeret de parseurs XML. 

• Prix. Une bibliotheque peut etre tres economique (maintenance/cout de 
developpement) tout en etant payante. II faut toutefois veiller a ce quelle 
n'implique pas des royalties faisant chuter la marge sur une vente de notre 
logiciel. 

• Maintenance. Quels sont les contrats proposes, quelle est l'equipe de deve- 
loppement, quel impact peut-on avoir sur l'ajout de nouvelles 
fonctionnalites ? 

• Qualite de la bibliotheque et de la documentation associee. II faut aussi 
tenir compte de la disponibilite de listes de diffusion/forums d'entraide et du 
nombre de livres/presentations relatifs au produit. 

BlueWeb joue la carte de l'Open Source 

BlueWeb sait faire la part des choses entre phenomenes de mode et realisme 
economique. Elle decide done de s'investir dans certains projets Open Source 
particulierement valables. 

• Log4j pour le mecanisme de gestion des logs (puissance de l'API, portabilite 
non limitee au dernier JDK 1.4.2) ; 

• Oro pour la gestion des expressions regulieres ; 
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• Castor XML, pour traiter la problematique de la transformation d'objets 
Java en XML et vice versa. 

Le chapitre 3 vous en dira plus sur ces trois bibliotheques. 

En cas de problemes majeurs ou de besoins specifiques, elle ne s'interdit pas de 
recourir a d'autres produits, mais ces deux choix cadrent deja en grande partie 
les developpements futurs. 

De meme qu'au niveau des conteneurs J2EE, BlueWeb n'a aucun interet a se lier 
avec un des tenors du marche et joue aussi sur ce plan la carte de l'Open Source 
en reduisant d'autant plus ses frais pour la phase de developpement, mais en 
n'excluant pas d'integrer sa solution sur d'autres conteneurs, suite a des souhaits 
emanant de clients (d'ou le souhait de portabilite et de respect des normes). 

Le tandem choisi est le duo de produits {bundle) JBoss + Tomcat, proposant une 
solution J2EE gratuite, bien documentee, soutenue par une tres large commu- 
naute de developpeurs. 

Le projet Jakarta Commons 

Le projet Jakarta (sous-projet Apache) a donne naissance a de multiples projets 
dont l'indispensable projet Ant presente precedemment. Parmi ceux-ci, il est 
bon de s'interesser a une boite a outils regroupant des composants repondant a 
des besoins frequents dans divers domaines : le projet Commons. 

Ce projet ambitieux met a disposition de tous des bibiotheques simples et puis- 
santes repondant a de nombreuses problematiques : 

• simplifier et standardiser le dialogue avec des composants serveurs (Net), 
commons-net ; 

• repondre a des carences du langage Java (Lang), commons-lang ; 

• amener une couche d'abstraction au dessus de la couche de gestion des traces 
utilisee (Logging), commons-logging ; 

• simplifier la gestion de fichiers de configuration XML (Digester) ; 

• fournir d'autres implementations aux interfaces de collections definies dans 
le paquetage j ava . uti 1 , commons-collections ; 

• fournir un framework a meme de simplifier la gestion des options dans un 
programme en ligne de commandes (CLI), commons-cli ; 

• et bien d'autres. 

Sans chercher a passer en revue tous ces outils, nous presenterons ici de courtes 
introductions pour quatre de ces produits. 

Introduction : I'univers de la ligne de commandes 

Meme si les interfaces graphiques sont dorenavant omnipresentes, l'epoque des 
outils fonctionnant en ligne de commandes n'est toutefois pas encore revolue. 
En effet, des qu'il s'agit d'automatiser le fonctionnement d'une application 



REFERENCE Le projet Commons 

La page web concernant les divers projets rassem- 
bles au sein de ce projet est : 
► http://jakarta.apache.org/commons 



B.A.-BA Pages de manuel 



Pour les lecteurs peu coutumiers du monde Unix, il 
est bon de rappeler que tout systeme Unix fournit 
a I'utilisateur un systeme d'aide en ligne, consuma- 
ble a tout moment par le biais de la commande 
man. 



(insertions dans une base en mode batch, manipulation journaliere de fichiers de 
donnees, etc.), le passage par des IHM complexes est exclu et les bons vieux 
outils en ligne de commandes reprennent tout leur sens. 

Pour tous ceux ayant eu a gerer des programmes pouvant accepter diverses 
options, il est inutile de rappeller le calvaire du programmeur devant gerer le 
controle des options passees par I'utilisateur en tenant compte des divers 
contextes : 

• informations obligatoires et options facultatives ; 

• options necessitant des valeurs et simples flags ; 

• options mutuellement exclusives... 

La figure 2-la propose une capture de la page de manuel de la commande 
Unix ps. Cette capture cherche juste a sensibiliser le lecteur sur la complexite de 
certaines commandes et sur le nombre d'options disponibles pour certaines 
d'entre elles. Dans le monde du langage C, une bibliotheque s'etait imposee : 
getopt. Celle-ci fournissait un moyen de simplifier la gestion des arguments 
pour tout programme ecrit en C ou C++. Commons CLI propose le meme type 
de fonctionnalites, mais adaptees au monde Java. 



Figure 2-1 a 

Capture d'ecran de la page de manuel 
de la commande ps 
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II faut aussi preciser qu'afin de simplifier la lecture des scripts de gestion des sys- 
temes Unix, on a introduit une notation plus verbeuse pour les diverses options 
des programmes, connue sous le nom de style GNU et opposee au tres austere 
style POSIX. II s'agit en fait simplement d'introduire des noms d'options expli- 
cites. On reservera traditionnellement l'utilisation des noms longs pour des 
scripts (augmentation de la clarte de ceux-ci), tout en utilisant les noms 
d'options abreges pour l'execution de commandes en mode interactif. 

Ainsi, la figure 2-lb propose un extrait de la page de manuel de la commande 
tar (gestion d'archives de repertoires). 




>top:rti... jeromecslaptop: lh.. 
TAR(l) Manuel de I ' utilisateur Linux 

NOM 

tar • la version GNU de I'utilitaire tar de gestion d'archives. 



TAB(l) 



SYNOPSIS 
tar 



[ - ] A 
| r - - append 
serve ] [ -b, 
-directory PEP ] 
- -force- local 
--incremental ] [ 



catenate - - concatenate | 
t --list | u --update | 
-block-size N ] ( 
[ --checkpoint ] [ 



( 

-fl» 



c --create | d --di-ff --compare 
-extract --get [ - -atiroe-pre- 
-B, -read- full- blocks ] [ -C, 

-f, -file [NOM_HOTE: ]F ] [ 



-F, - -info-script F - -new-volume-script F ] [ -G, 
- -listed-incremental F ] [ -h, --dereference ] [ 
-l, --ignore-zeros J [ -j, -I, --bzip ] [ - -ignore-f ailed- read ] [ - k, 
- -keep-old-files ] [ -K, - -starting- file F ] [ -I, - -one-file-system 1 
[ -L, -tape-length N ] [ -m, - -modification- time ] [ -M, -multi-vol- 
ume ] [ -N, --after-date DATE, --newer DATE ] [ -o, - -old- archive, 
--portability ] [ -O, --to-stdout ] [ -p, --same-permissions, --pre- 
serve-permissions ] [ -P, --absolute-paths 3 [ --preserve ] [ -R, 
--record- number ] [ --remove-files ] [ -s, --same-order, --preserve- 
order ) [ -same-owner ] [ -S, -sparse ] [ -T, -files-from F ] [ 
--null ] [ --totals ] [ -v, --verbose ] [ -V, --label NOM ] [ 
--version ] [ -w, --interactive, --confirmation ] [ -W, --verify ] 
[ - exclude naUCTt ] [ -X, - exclude -from naiDl ] [ -Z, - compress, 
-uncompress ] [ -z, -gzip, -ungzip ] [ 
POOG ] [ -block -compress ] [ [0-7][lmh] ] 



nomfichierl { nomf ichier2, ^ nomfichierN 1 
repertoirel I repertoire2. „. repertoireN ) 
DCGCraPTION 

Voici la page de manuel de la version GNU de tar, un programme de ges- 
tion d'archive utilise pour creer et reataurer des fichiers a partir 
d'une archive connue sous le nom tarf lie . Un fichier tarf lie peut etre 
sur un lecteur de bande, cependant ll est possible de produire un 
fichier tarf lie comme un fichier normal. Le premiere argument de tar 
doit etre obligatoirement une de ces lettres : Acdrtux, suivie par 



Figure 2-1 b 

Options de la commande tar 



Cette figure permettra au lecteur diligent de remarquer que certaines options 
seront disponibles sous deux formes : 

• une forme abregee par le biais d'une simple lettre (c pour create par exem- 
ple), destinee a une utilisation au quotidien ; 

• une forme developpee (create) destinee a une utilisation dans un script. 

II s'agit bel et bien d'un progres facilitant la comprehension de scripts d'admi- 
nistration complexes... 
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Le projet Commons CLI 

Ce projet vise a fournir une bibliotheque de bon niveau permettant de faciliter 
autant que faire se peut la creation de programmes necessitant des options sai- 
sies par l'utilisateur au lancement du programme. 

II va done fournir des classes permettant de modeliser les intervenants dans ce 
contexte, a s avoir : 

• une instance d'une implementation de l'interface org . apache . commons . 
cli . CommandLi neParser, permettant d'obtenir une reference sur un objet 
du type org. apache. commons. cli .CommandLi ne modelisant la ligne de 
commandes ; 

• une instance de la classe Options, representant l'ensemble des options 
gerees par un programme, et pouvant etre instanciee directement ou en pas- 
sant par la methode statique de la classe OptionBui lder. 

Les principales relations entre intervenants sont detaillees dans le schema UML 
de la figure 2-2. 



PosixParser 



GnuParser 



Figure 2-2 

Relations entre intervenants 



•y v 



CommandLineParser 



+parse( Opt ions, String! ] ) 



I 

V 



Options 



i 
i 

V 



OptionBuilder 



+create( ) 



CommandLine 



Rien de tel qu'un petit exemple pour apprehender ces concepts... 

Le code suivant permet de gerer une application dotee de diverses options : 

• hel p(h) pour obtenir de l'aide ; 

• exit (x) pour sortir ; 

• config (c) pour utiliser un fichier de configuration transmis avec l'option 
file. 

II n'y a pas de quoi revolutionner l'informatique, mais e'est un programme suffi- 
sant pour demontrer la puissance du produit... 
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package commons. cli ; 

import org. apache. commons. cl 
import org. apache. commons. cl 
import org. apache. commons. cl 
import org. apache. commons. cl 
import org. apache. commons. cl 
import org. apache. commons. cl 
import org. apache. commons. cl 
import org. apache. commons. cl 
import org. apache. commons. cl 
import org. apache. commons. cli 

public class CliExemple { 



.BasicParser; 

.Command Line; 

. CommandLi neParser ; 

.CnuParser; 

.HelpFormatter; 

.Option; 

.OptionBuilder; 

.Options; 

.ParseException; 

.PosixParser; 



public static void main(String[] args) { 
Options options= new OptionsO; 
Option help = new Option( "h", "help", false, 

"print this message" ); 
Option exit= new Option("x", "exit", false, 

"exit the application"); 
Opti onBui 1 der . wi thArgName("f i 1 e") ; 
OptionBuilder.hasArgO ; 
Opti onBui 1 der . wi thDescri pti on( 

"specify the config file to be used"); 
OptionBuilder .isRequi red(fal se) ; 
Opti onBui 1 der . wi thLongOpt ("conf i g") ; 
Option config= OptionBuilder. create("c") ; 
options. addOption(config) ; 
options. addOption(help) ; 



Imports necessaires au programme et declara- 
tion du paquetage hote 



Une classe demontrant 
theque Commons Cli. 



'utilisation de la biblio- 



Etape n°1 : definir les differentes options gerees 
par le programme. 

Ici ce programme test est assez pauvre done ne 
gere que trois options : 

• hel p pour obtenir de I'aide, 

• exi t pour quitter, 

• config pour passer un nom de fichier de 
configuration. 

Bien entendu, le programme ne fait rien d'utile 
de ces options... 



CommandLi neParser parser = new BasicParserO ; 

try{ 

CommandLine line = parser. parse( options, args ); 



if (line.hasOption("h")){ 
HelpFormatter formatter = new HelpFormatter () ; 

formatter. printHelp( "CliExemple", options ); 
} 

// a t'on donne un fichier de config en param ? 
if(line.hasOption("c")){ 
// il semble que oui . . . 
// quel est ce fichier ? 

System. out. println("fais qqch du fichier de config 
line.getOptionValue("c")) ; 

} 



II s'agit ensuite de definir le type de parseur 
manipule pour la gestion des options de notre 
programme. Ici e'est un parseur minimaliste qui 
a ete choisi. Une fois le parseur instance, on 
peut se lancer dans le parsing des options pas- 
sees par I'utilisateur (d'ou I'utilisation de la 
variable args). Notez bien le type retourne : 
CommandLi ne. 



On peut desormais exploiter I'instance de 
CommandLi ne (ligne de commandes) obtenue 
en la questionnant notamment par le biais de sa 
methode hasOpti on () . 
On note la necessite de gerer une exception du 
type ParseException. 
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if (line.hasOption("x")){ 

System. out. println("See you next time"); 

System. exit(l) ; 

} 

} 

catch( ParseException exp ) { 



// oops, something went wrong 

System. err. println( "Parsing failed. Exception is =" + 

exp.toStringO +" Reason: " + exp.getMessageQ ); 



} 



} 



Figure 2-3a 



Les figures 2-3a, 2-3b et 2-3c montrent divers lancements de l'application vus 
dans la console d'Eclipse. 

Figure 2-3b 



Problems 



Javadoc 



Declaration 



inated> CliExemple [Java Application] /home/jerome/j2sdkl. 4. 2_C 

usage: CliExemple 
-c,- -config <file> specify the config file to be used 
-h,--help print this message 



File Edit Source Refactor Navigate Search Project Jonas Run 



\* \* 3! 



Problems 



Javadoc Declaration 



<terminated> CliExemple [Java Application] /home/jerome/j2sdkl.4.2_0! 



fais qqch du fichier de config =file=titi . properties 



Figure 2-3c 


"> Mi si \* \* « £ 


fr- o- q.- , oa m | » v | j ft |ia- ^ o» 




I'roblcmc javadoc ucclaration 




■ * J « t? ■• 


<t#rmmM*d> riirxompl* Java 


ApplirAtionjyhom«)Af>romi»/)?ndk1 4?JK/hififlmm (?1 nw. 7004 in^OrM) 




Patai ng tailed. Fxr^ption 


1 s -org. ApAche. commons. r 1 1 .IJnrw ogm 7ffdOpti onFicftpti on: imr^rngm 7*d option : - -i nvAl 1 d-opti on FteAfton: 


Ijhrecogni 7«d opti on: - -i nvAlid-opti on 



L'exemple suivant illustre comment creer des groupes d'options de maniere a 
creer des arguments mutuellement exclusifs. Ainsi, dans le cas d'un programme 
d'archivage et de compression (tel le fameux Winzip), l'utilisateur ne pourra 
choisir lors de la meme invocation qu'une option entre compression et decom- 
pression. 



Declaration du paquetage et imports necessaires 
au programme. 



package commons. cli; 

import org. apache. commons. cl 

import org. apache. commons. cl 

import org. apache. commons. cl 

import org. apache. commons. cl 

import org. apache. commons. cl 

import org. apache. commons. cl 

import org. apache. commons. cl 

import org. apache. commons. cli 



.CommandLine; 

. CommandLi neParser ; 

.CnuParser; 

.Option; 

.OptionCroup; 

.Options; 

. ParseException ; 

.PosixParser; 
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* <p> 

* Cet exemple va creer des groupes d'options mutuellement exclusives 

* ainsi dans le cas d'utilisation d'un utilitaire d'archivage 

* on va chercher a compresser ou decompresser mais pas les 2 en meme 
temps 

* </p> 

* ©author jerome@j avaxpert.com 

V 

public class AdvancedCli Example { 

public static void main(String[] args) throws ParseException { 
Option compress= new Opti on ("c", false, 

"compress the given file"); 
Option uncompress^ new Option("x", false, 

"uncompress the given file"); 
OptionGroup group=new OptionCroupO ; 
group. addOption(compress) ; 
group. addOption(uncompress) ; 
Options opts= new Options(); 
opts.addOptionCroup(group) ; 
CommandLineParser parser = new GnuParserO; 
CommandLine line=parser.parse(opts,args) ; 
if("line.hasOption("c")){ 

System. out. println(" compression demandee") ; 

} 

i f (1 i ne . hasOpti on ("x")) { 

System. out. println("decompression. . . ") ; 

} 

} //main() 

} 

Les figures 2 -4a et 2 -4b illustrent la console d'Eclipse lors de deux lancements 
de ce programme avec une option de compression ou avec les deux options posi- 
tionnees (ce qui est inacceptable a nos yeux). 



Ici, on va batir les options a partir d'un groupe 
d'options, c'est-a-dire une instance de la classe 
OptionGroup. Cette classe modelise les 
options mutuellement exclusives (ici compres- 
sion et decompression). 



oblems Javadoc Declaration^ 

ated> AdvancedCliExample [Java Application] /home/jerome/j2sdkl.4.2_05/bin/ja 



[decompression. 



Figure 2-4a 



rxception in thread "nam org . apache . ccmrrors . ell . Alreadybelectedbxception : an option "rom this group has already been selected: ■ 
at org. apache. commons. cli . OptionGroup. setselectedloptionGroup.java: 129) 
d L Uf y . dpdche .cumitiuris .cli .Par sm . pr ucessOpli um (Parser . j dvd : 272) 
at org . apache . commons . cli .Parser . parse (Parser . j ava : 170) 

at org . apache .commons .cli .Parser . parse (Parser . j ava : 114) Figure 2— 4b 

at commons . cli . AdvancedCliCxample . main (AdvancedCli example . J ava : 32) 
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PRECISION Les difficulty du Web 

Ce projet prend tout son sens quand on saisit le 
nombre de finesses et de pieges propres au deve- 
loppement en utilisant le protocole HTTP : gestion 
des divers types de requetes (POST/GET), manipu- 
lation de cookies, autant de cas concrets pour les- 
quels le langage Java n'offre guere de facilite. 



PIEGE Attention aux versions 

Comme toujours dans le monde du logiciel libre, 
il s'agit d'etre extremement attentif aux ver- 
sions utilisees. La derniere version courante de 
production est la 2.0.2 tandis qu'on peut deja se 
familiariser avec la version 3.0-alpha2. Cette 
version necessite une autre bibliotheque du pro- 
jet Commons : Commons Codec, qui permet de 
prendre en compte divers formats (codecs). 



Commons HTTP client 

Lasse par la pauvrete des interfaces web developpees en HTML standard ou 
effondre par le manque de portabilite des scripts JavaScript ? Le developpement 
de clients lourds invoquant des composants serveurs par requetes HTTP est 
devenu une pratique frequente... 

Neanmoins, malgre la richesse du langage Java et de sa couche reseau en parti- 
culier, l'invocation d'une page web n'est pas chose simple. Inutile de reinventer 
la roue et de reinvestir du temps dans des parties techniques, mieux vaut utiliser 
une bibliotheque eprouvee, telle que Commons HTTP client. 

Le projet 

Etendre le spectre des fonctionnalites offertes par le paquetage java.net tout 
en vous permettant d'etendre le produit et de l'adapter a vos besoins, tel est le 
defi releve par ce projet. 

LURL permettant de telecharger le produit est la suivante : 
► http://jakarta.apache.org/commons/http-client/. 

Le produit n'exige qu'une seule dependance : Commons Logging, la biblio- 
theque d'abstraction du paquetage de gestion des traces applicatives. 

Methodologie d'utilisation du produit 

L'invocation d'une page sur un serveur web (par le protocole HTTP) et le trai- 
tement de la reponse reclament les etapes suivantes : 

• instanciation de la classe centrale du produit HttpCl i ent ; 

• instanciation d'une methode d'invocation de la page par le biais d'une 
implementation concrete de HttpMethod (la classe GetMethod par 
exemple) ; 

• execution de l'invocation (et traitement des erreurs eventuelles) ; 

• traitement de la reponse ; 

• restitution des ressources (connexion HTTP). 

Ce scenario type masque quelque peu la puissance du produit, puisque chaque 
etape peut etre adaptee aux besoins precis de votre application. 

Avant de rentrer dans des details d'adaptation du produit a vos besoins, exami- 
nons la traduction en code Java de ce scenario. 

Applications exemples 

Nous allons aborder ici un exemple simpliste d'utilisation de la bibliotheque, 
permettant d'introduire les principaux acteurs. II s'agira ici d'afficher dans la 
console le contenu de la page d'accueil delivree par Apache en local sur une 
machine GNU Linux Debian. 

Soit une page conforme a la copie d'ecran proposee en figure 2-5. 
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Document £dltlon Afflchage A]ler Signets Oytils Configuration Fenftre Ajde 

Q.Q.Q.O QO k i 



O UBI :\<j http//localhost/apache2-default/( 
[t?l vector <T, Allot: > 



MNavlgateur dans li 
■ _Navigateur dans li 
» 'Navfgateur de CD 

, > ^HeYiphengues 

\ I JTCollces 



if you can sec this, it means that the installation of the Apache web server software on tl 
system was successful. You may now add content to this directory and replace this paqe. 



Seeing this Instead of the website you expected? 

This page is here because the site administrator has changed the configuration of this web 
server Please rnntart the person respnnsihle tor maintaining this server with 
quustiuns. The Apache Sollwaie Foundation, wtutli wiute the web server sollware this site 
administrator is using, has nothing m do with maintaining this site and cannot help resolve 
lonliuuralign issues. 



The Apache documentation has been included with this distribution. 

You are free to use the imaqe below on an Apache-powered web server. Thanlcs for using 
Apache ! 



Figure 2-5 

La page d'accueil 
d'Apache 2 



Pour cela, on utilisera le code suivant : 
package commons . http; 

import java.io.IOException; 

import org . apache . commons . httpcl i ent . HttpCl i ent ; 
import org . apache . commons . httpcl i ent . HttpExcepti on ; 
import org . apache . commons . httpcl i ent . HttpMethod ; 
import org . apache . commons . httpcl i ent . HttpStatus ; 
import org . apache . commons . httpcl i ent . methods . GetMethod ; 



Declaration du paquetage contenant ces exem- 
pts. 



Imports necessaires au programme. 



/** 

* <p> 

* Ouvre une connexion HTTP avec une requete de type GET sur la 

* page d'accueil d'un serveur web (port par defaut 80) en local. 

* Affiche le resultat (page HTML) dans la console... 

* </p> 

* @author jerome 

V 



public class SimpleHttpClient { 



public final static String TARGET_URL="http: //local host: 80"; 

public static void main(String[] args) { 
// client HTTP 

// permet d'obtenir de nombreuses infos 

// et de parametrer le dialogue 

// mais utilise ici sans fioritures 

HttpClient client=new HttpCl ient() ; 
HttpMethod method=new GetMethod (TARGET URL) ; 



< Definition de la classe. 



Definition d'une constante correspondant a la 
page demandee. 

Les objets au centre de I'API Commons Http- 
Client sont : 

• les instances de la classe HttpCl i ent ; 

• les instances de la classe HttpMethodParams. 
Ces derniers modelisent les diverses facons 
d'invoquer une page web telles que definies 
dans la RFC officielle. 

Ici, il s'agit d'un test simple, done utilisant une 
requete de type GET. 
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Lance la recuperation de la page. 

Attention : le caractere oriente reseau de cette 

demarche implique la gestion de differente 

exceptions. 

La methode executeMethod retourne un 
status de I'invocation. 



L'objet method nous permet de recuperer la 
reponse sous forme d'une chame. 



Qu'il y ait ou non une exception, on libere la 
connexion HTTP detenue. 



} 



} 



try { 

i nt status code=cl i ent . executeMethod (method) ; 
i f (status_code ! =HttpStatus . SC OK) { 
System, out. println( 

"probleme lors de la tentative d ' invocation") ; 

} 

// ok eel a va bien. . . 

String result_page=method.getResponseBodyAsString() ; 

System, out. println( 

"Page recue depuis le serveur web:\n"+ result_page) ; 
} catch (HttpException e) { 

e.printStackTrace() ; 
} catch (IOException e) { 

e.printStackTrace() ; 

} 

finally!" 

// libere la connexion 
method . rel easeConnection() ; 

} 



La figure 2-6 represente la sortie capturee dans Eclipse d'une execution de ce 
programme. 



Figure 2-6 

La sortie capturee 
dans la console Eclipse 



loglj :WARN \o spponaors could be found far ".oggor ; org . apache . consols . httoc li on t . -ttpC'.i ont 
log4j :WARN Please initialize the log4j system properly. 
Page recue depuis le serveur web: 

<!OOCrfPi: html PUOUC ■•//W3C//DTD XI ITU. l.O Transitlonal//CN" 
•lillp: //www. w3.org/TrVxlilirill/DTD/xhUrill- transitional. did' > 
<html xmlns-" http://www.w3.org/19Q9/xhtml"> 

*title>lest Page for Apache installations/title* 
</head> 

<>■■ Rackgrnund white, links hlup (unvi si Ted) , navy (visited), red 
(active) > 

sbody bgcolor ="#FFFFFF" lexl="*OOOOOG- Unk=-#OOO0FF" 
vUnk-»#000080' alink- , #H=0000 , » 

<p>If you can see this, it means that the installation of the <a 
href ="http : //www. apache . org/f oundation/prei-AQ. html" >Apache web 
scrvcr</a> software on this system was successful. You may now add 
content to this directory and replace this page.</p:» 

<hr width-'50V size-*8" /> 

<A\2 align="center-»seeing this instead of the website you 
expected? </h2> 

<p>Thio page is hero because the cite administrator has changed the 
configuration of this web server . Please sslrongp-curilact Ihe person 
responsible for maintaining this server with questions. </strong> 
The Apache Software Foundation, which wrote the web server software 
rhis sire admi ni srrator is using, has noThing ro dn wi rh 
maintaining this site and cannot help resolve configuration 
.•s/p» 



<hr width-" 50V size-" 8" /> 

*p»lhe Apache <a href='/manual/'»documentation«:/a:> has been included 
with this distribution. </p> 

<p>You arc tree to use the imago below on on Apache powered web 
server. Thanks for using ApacheWp* 

<div align="center"xirrK] src='apache pb.gif" alt=" /x/div> 
</body> 

</html> 
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Communication avec un serveur web par la methode POST 

Afin de contourner les limitations en terme de volume de donnees transmises par 
le buffer entre le client (navigateur ou client lourd) et le serveur inherentes a la 
methode GET, le protocole HTTP introduit une methode POST utilisant un buffer 
pour le transport des parametres et de la reponse. La validation de formulaires est 
l'exemple le plus remarquable d'utilisation de cette facilite du protocole. 

Le code suivant demontre comment mettre cette forme de dialogue en oeuvre. 

package commons . http; 
import java.io.IOException; 

import org . apache . commons . httpcl i ent . HttpCl i ent ; 
import org . apache . commons . httpcl i ent . HttpExcepti on ; 
import org . apache . commons . httpcl i ent . HttpMethod ; 
import org . apache . commons . httpcl i ent . HttpStatus ; 
import org . apache . commons . httpcl i ent . methods . PostMethod ; 

* <p> 

* invoque une des servlets exemples de Tomcat 

* en utilisant la methode POST du protocole HTTP 

* </p> 

* ©author jerome 

V 

public class PostClient { 

public final static String TARGET_URL= 

"http : //l ocal host : 8080/se rvl et/Requestlnf oExampl e" ; 
public static void main(String[] args) { 
HttpClient client=new HttpCl ientO ; 

HttpMethod method=new PostMethod (TARGET URL) ; 

try { 

int status code=cl ient .executeMet hod (method) ; 

i f (status_code ! =HttpStatus . SCJ3K) { 
System. out. println( 

"probleme lors de la tentative d ' invocation") ; 

} 

String result page=method.getResponseBodyAsString() ; 

System. out. println( 

"Page recue depuis le serveur web:\n"+ result_page) ; 
} catch (HttpExcepti on e) { 

e.printStackTrace() ; 
} catch (IOException e) { 

e.printStackTrace() ; 

} 

final ly{ 

method. releaseConnection() ; 

} 

} 

} 



< Declaration du paquetage 

< I Imports necessaires au programme 



< Definition de la classe 

< I Constante representant la page appelee.. 



< Le client va ici utiliser une methode de type 
PostMethod. 

Tout le reste du code reste identique... 



Pour tester ce code, il suffit de demarrer un serveur Tomcat, puis de lancer le 
code du client. 

A ce moment, on peut obtenir une sortie du type : 

Page recue depuis le serveur web: 
<html ><bodyxhead> 

<title>Exemple d' 'information sur la requete</title> 
</head> 

<body bgcolor="white"> 

<a href=". ./reqinfo.html"> 

<img src=" . . /images/code. gif" height=24 width=24 align=right border=0 

alt="view code"x/a> 

<a href=". ./index. html"> 

<img src=". ./images/return. gif" height=24 width=24 align=right 
border=0 alt="return"x/a> 

<h3>Exemple d' 'information sur la requete</h3> 

<tabl e border=Oxtrxtd>Methode : </td> 

<td>POST</tdx/tr> 

<trxtd>URI de requete:</td> 

<td>/servlet/RequestInfoExample</tdx/tr> 

<t rxtd>Protocol e : </ td> 

<td>HTTP/l . l</tdx/t r> 

<trxtd>Info de chemin:</td> 

<td>null</tdx/tr> 

<trxtd>Adresse distante:</td> 

<td>127 . 0.0. l</tdx/trx/tabl e> 

Simple n'est-ce pas ? Pas de temps perdu a gerer les subtilites du protocole 
HTTP, simplement du code 100 % utile... 

Adaptation du produit a vos besoins 

Poussons un peu plus avant nos investigations et examinons quelques fonction- 
nalites avancees offertes par le produit... 

L'exemple precedent ne prenait que peu en compte les problemes inherents a 
l'utilisation d'un reseau et passait sous silence l'eventuel echec des connexions 
vers le serveur HTTP distant. 

Que se passe-t-il maintenant si Ton cherche a atteindre un site distant et non 
local et que la connexion echoue ? La bibliotheque renverra-t-elle une exception 
ou un code d'erreur lors de la premiere tentative infructueuse ? 

Avec la version 3.0 de la bibliotheque, cette reponse est definitivement non, car 
l'aspect communication reseau de la bibliotheque fait apparaitre une classe asso- 
ciee a la methode d'acces a la page (l'instance de la classe HttpMethod) : le 
MethodHanl er. 

Ceci nous permet d'adopter la politique de notre choix, lors de la tentative de 
connexion vers un site. 

Cette configuration se fera en precisant sur l'objet HttpMethod un parametre de 
type HttpMethodParams . RETRY_HANDLER. L'implementation exacte de cet 



objet est a choisir entre une implementation par defaut (fournie par la biblio- 
theque) et une implementation plus personnelle... 

Ceci nest qu'une des nombreuses possibilites d'extension envisageables avec 
cette bibliotheque. La documentation de l'API permettra au lecteur interesse de 
connaitre la liste exhaustive de ces points d'extension. 

Commons Collections et Commons Primitives 

Les structures de donnees sont les veritables fondations de tout projet. Ces deux 
projets s'interessent a compenser des carences laissees par le paquetage standard 
java.util malgre l'apparition depuis leJDK 1.2 des fameuses Collections. 

Le paquetage Commons Collection vous fournit diverses collections permettant 
aux developpeurs de trouver des reponses pragmatiques a divers besoins recur- 
rents. Ainsi, vous cherchez un cache pour vos objets, allez-vous devoir le deve- 
lopper vous-meme ? Ce cache se doit d'utiliser un algorithme base sur la fre- 
quence d'utilisation des divers objets, mais le paquetage java.util ne fournit 
rien de tel en standard. 

Vbtre application fait grand usage d'entiers, de flottants ? Vous avez constate 
l'impossibilite d'utiliser des collections Java pour stocker vos objets et vous avez 
decide de contourner ceci en instanciant les diverses classes wrappers du paque- 
tage java.lang (integer, Float etc.). Quel dommage et quelle perte de res- 
sources (memoires et CPU) ! Pas de panique, le projet Commons Primitives 
permet de stocker vos types primitifs dans des listes, fournit la possibilite 
d'obtenir des iterateurs. 



PRECISION Caches applicatifs 

Le cache ici presente est le type le plus simple pos- 
sible. Pour des besoins plus ambitieux, il faudra 
regarder du cote de divers projets libres parmi les- 
quels on peut citer ehcache. 



Creation d'un cache d'objets 

Dans cet exemple, nous allons simuler la creation d'un cache d'objets, c'est a 
dire un conteneur d'objets de taille maximale fixee (ici 10) devant decider des 
objets a eliminer en etudiant la frequence d'utilisation de ceux-ci. Nous simu- 
lons ainsi le fonctionnement d'un cache au sein d'un serveur d'applications. 

package commons. col lections; 

import java.util .Iterator; 
import java.util .Map; 

import org . apache . commons . col 1 ecti ons . LRUMap ; 

/' 

<p> 

Mise en evidence de la puissance des implementations proposees 
par le projet Commons Collections. 
Programme de test utilisant une implementation 

* de 1 'interface java.util .Map propre a ce produit. 

* II s'agit ici d'experimenter la LRUMap permettant de creer des 

* caches tels que ceux utilises dans 1B0SS et autres serveurs 

* d'applications. 

* ©author jerome 
* 

*/ 



< Declaration du paquetage. 

< I Imports necessaires. 
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Declaration de la classe. 



Cette methode est un petit utilitaire permettant 
de connaitre le contenu d'une map. 



Notre exemple va debuter en remplissant une 
structure avec dix elements. Notre map est 
implementee en utilisant une des classes du pro- 
jet Commons Collection: la LRUMap. 
Notre map a pour contrainte (d'apres le cons- 
tructed) d'etre limitee en taille a 10 elements. 
Nous allons experimenter ceci en provoquant la 
sortie du cache d'un des 10objets. Pour cela, 
nous devrons solliciter certains objets (les 
9 premiers), ainsi le cache saura qu'un des 
objets a moins de chance d'etre desire et I'elira 
done a I'eviction. 



public class CollectionsExemple { 
// affiche le contenu d'une Map 

// methode utititaire 

static void displayMap(final Map aMap){ 

for (Iterator iter=aMap.entrySet() .iterator() ;iter.hasNext() ;){ 
Map. Entry entry=(Map.Entry)iter.next() ; 
System. out. println("cle = "+ entry. getKeyO + 

" valeur =" + entry. getValueO) ; 

} 

} 

public static void main(String[] args) { 

String [] KEYS={"coucou" , "hello"," tutu", "tata","titi", 

"monde" , "world" , "hallo" , "welt" , "ki ki "} ; 
// obtenir une reference sur une Map implementee sous forme 
// d'une LRUMap. Une fois pleine (ici 10 elements car precisee 
// dans le constructeur) cette structure va evacuer des objets 
// en scrutant les dates de derniere utilisation tres utile pour 
// batir des caches d'objet de taille fixe comme dans le cas de 
// serveurs d' applications 
Map map = new LRUMap (10); 
// remplit la map 
forO'nt i=0;i<10;i++){ 

map.put(KEYS[i] ,new Integer(i)) ; 

} 

// accede aux objets de la map 
// tous sauf le dernier element (kiki) 
for(int i=0;i<9;i++){ 
map.get(KEYS[i]); 

} 

di splayMap(map) ; 

// on ajoute un element mais la taille maximale est atteinte 
// il faudra supprimer 1 'element utilise il y a le plus de 
// temps. . . 

map.put("nouveau" ,"salut lava") ; 
// on affiche la nouvelle Map 
displayMap(map) ; 
}//main() 

} 



Utilisation des Commons Primitives 

L'exemple de code suivant illustre une utilisation basique de ce projet afin de 
stacker une large collection d'entiers avant de realiser la somme de ces nombres 
de maniere a retrouver la formule de Gauss donnant la somme des n premiers 
entiers naturels : n*n(+l)/2. 

Declaration du paquetage hote ► 
Imports necessaires au programme. 1 ► 



package commons . primitives ; 

i mport org . apache . commons . col 1 ecti ons . primi ti ves . ArraylntLi st ; 
import org . apache. commons . col 1 ecti ons .primitives . Intlterator ; 
i mport org . apache . commons . col 1 ecti ons . pri mi ti ves . IntLi st ; 
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/** 

* <p> 

* Utilisation du paquetage Commons Primitives pour stocker 

* une liste d'entiers. Cette "liste d'entiers (1,2,3 ,n) 

va ensuite etre utilisee de maniere a realiser la somme 
des entiers naturels on va retrouver le fameux resultat 
du a Gauss : n*(n+l)/2 
</p> 

* ©author jerome@javaxpert.com 

* 

V 

public class SommeEntiers { 
// fix the number of elements 

private final static int MAX_ELEMENTS=500000; 

public static void main(String[] args) { 
int sum=0; 

// utilisation d'une structure proche d'une liste 
// a la sauce java.util .List 

IntList int_list= new ArrayIntList(MAX„ELEMENTS) ; 
f o r (i nt i =0 ; i <MAX_ELEMENTS ; i ++) { 
int_list.add(i) ; 

} 

// Utilisation d'un iterateur proche du java.util .Iterator 

for(lntlterator iter=int_list.iterator() ;iter.hasNext() ;){ 
sum+=iter.next() ; 

} 

System. out. println("La somme des N premiers entiers ou N = " + 
MAX_ELEMENTS + "est =" + sum + 
"\nLa formule predit =" + 
(MAX_ELEMENTS*(MAX_ELEMENTS+l)/2)); 

} // mainC) 

} 

Ces petits exemples n'ont pour seule ambition que vous faire apprehender 
l'eventail de possibilites offertes par le projet Commons. A travers les projets 
presentes, il faut bien retenir le spectre couvert par ce projet que Ton pourrait 
qualifier de meta-projet. II couvre des besoins lies a des domaines aussi varies 
que les structures de donnees, la programmation reseau, la manipulation de 
Beans et de fichiers XML, la gestion de traces et bien d'autres. Une veritable 
aubaine pour tout developpeur Java. 



Declaration de la classe. 
Definition d'une constante. 



Definition de la structure (ArraylntLi st) 



Remplissage de la structure. 



Utilisation de la structure de donnees (contenant 
les entiers) par le biais d'un iterateur. 



En resume... 

Les outils centraux de l'equipe de developpement sont dorenavant poses. Ant va 
nous permettre d'orchestrer les procedures de controle de la qualite du code 
source, de generation des versions et le deploiement de l'application. Quant a 
CVS, il est la pour aider a produire et gerer des versions. Enfin, le probleme epi- 
neux du choix d'une bibliotheque a ete resolu. 
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Interfaces graphiques 
pour la couche cliente 



L'interface graphique d'une application est la partie « visible » 
pour un utilisateur. La negliger annule tout le travail fait en 
amont. L'ergonomie de notre application va done conditionner 
son utilisation. Reactivite, presentation, sobriete, sont autant 
de facteurs a prendre en compte pour ne pas passer a cote de 
nos objectifs. 



SOMMAIRE 

► Choix de la bibliotheque SWT 

► Retour a I'application de 
gestion des signets 

► Validation du code 

► Le framework JUnit 

► Gestion des traces applicatives 

MOTS-CLES 

► GUI/IHM 

► Eclipse/SWT 

► Widgets 

► Pattern Decorateur 

► Validation des saisies/expres- 
sions regulieres 

► JUnit 



Choix de la bibliotheque SWT 



A IDE 

Integrated Development Environment 

Un environnement de developpement integre desi- 
gne un outil regroupant les fonctions d'edition, de 
compilation et de debogage. Ainsi, Visual C++, 
Borland C++, JBuilder ou JCreator peuvent etre 
cites parmi la longue liste des IDE disponibles sur 
le marche. 



B.A.-BA WSAD (WebSphere Studio 
Application Developer) 

WSAD est une surcouche commerciale d'Eclipse 
developpee par IBM et remplacant I'ancien envi- 
ronnement de developpement de cette societe : 
Visual Age. 



Fondation Eclipse 

La fondation Eclipse regroupe une cinquantaine de 
societes (Toshiba, IBM, Borland, Rational, etc.). 



OUTIL Lucene 

Lucene est un autre projet de I'Apache Group. II 
s'agit d'un moteur de recherche en texte libre 
extremement performant, facilement adaptable a 
vos besoins puisqu'il est code en Java, manipula- 
te aisement dans des contextes aussi differents 
qu'une application autonome ou un contexte J2EE. 



Tous les criteres precedemment evoques pourraient etre utilises afin d'apporter 
un element de plus dans la bataille de l'API graphique opposant, a ma gauche, 
Swing le poids lourd de Sun, contre, a ma droite, SWT le challenger. Une 
recherche sur Internet vous permettrait de trouver un grand nombre d'articles 
tentant d'opposer les deux bibliotheques. Cette approche est un peu sterile car, 
d'un point de vue pragmatique, il est preferable d'avoir du choix. . . 

Mais ce choix de SWT trouve une bien meilleure justification si, comme 
l'equipe de BlueWeb, on voit en Eclipse bien plus qu'un simple IDE car, outre 
cet aspect, Eclipse se revele etre une plate-forme logicielle fabuleuse : 

• riche en fonctionnalites ; 

• facilement extensible ; 

• aisement configurable. 

En effet, Eclipse peut etre percu comme un receptacle universel faisant tourner 
des applications n'ayant que peu ou pas de rapports avec Java. Ainsi, un plug-in 
Eclipse dote votre environnement d'un IDE pour C/C++, un autre vous renvoie 
dans le passe avec un environnement dedie au Cobol, d'autres enfin permettent 
de gerer Tomcat ou JBoss. Certains editeurs comme Rational ont deja franchi le 
pas et proposent dorenavant leurs nouveaux produits sous forme de plug-ins. 
XDE est ainsi le successeur de Rational Rose. Le plus etonnant dans le mouve- 
ment autour de ce produit est l'organisation sous forme d'un consortium ouvert, 
ce qui est vraiment deroutant puisque Ton retrouve des societes aux interets a 
priori concurrents reunies autour de la table de discussion... 

Se pourrait-il que tous ces editeurs voient en Eclipse le receptacle tant attendu ? 
Comment echapperaient-ils aux attraits d'un produit deja dote de ce qu'il y a de 
mieux sur le marche, avec par exemple un systeme d'aide en ligne contextuelle se 
basant sur Lucene et Tomcat ? 



B.A.-BA La notion de placement automatique (layout) 

II est indispensable d'introduire la notion de layouts dans ce chapitre dedie a I'interface graphi- 
que. C'est une notion cle dans le developpement d'interfaces graphiques. II s'agit d'utiliser un 
algorithme de placement des composants (layout) permettant de s'adapter dynamiquement a 
des changements de contexte (redimensionnement de I'ecran, ajout de composants) plutot que 
de specifier explicitement la localisation de chaque bouton ou fenetre (par les coordonnees X/Y). 
On peut imaginer un grand nombre d'algorithmes ayant leurs contraintes propres (contraintes 
cartographiques (Est, Ouest, Nord, Sud), pourcentage, etc.). Cette notion de layouts a done le 
principal merite d'eviter les problemes facheux lies aux tallies d'ecran (boutons invisibles en pas- 
sant d'un moniteur 1 7 pouces a un 1 5 pouces) et done d'eviter de lier son interface a une resolu- 
tion d'affichage. En revanche, les layouts induisent un developpement plus complexe (pas de 
solution satisfaisante parmi les rares outils proposant des aides graphiques a la construction 
d'lHM), ainsi qu'un cout en matiere de performances (puisqu'il y a calcul la ou classiquement on 
amenait des coordonnees figees). II est unanimement reconnu que dans le monde Java, toute 
interface graphique doit utiliser ce type de strategie. II faut mettre en garde le lecteur contre cer- 
tains outils proposant des layouts permettant de positionner des composants « en dur , 



48 



Malgre tout, SWT est encore un projet jeune. C'est pourquoi il faut quand 
meme preciser qu'il reste des bogues ou des maladresses de coherence dans la 
conception du produit. Par exemple, on peut citer le fantome dans le cas de 
l'utilisation d'une table SWT, des incoherences dans les hierarchies de classes 
(comme la classe KeyEvent qui n'herite pas de Event). Cependant, le potentiel 
est enorme et l'existant plus que seduisant... 



IDEE RECUE La creation (('interfaces graphiques est une chose simple 

Contrairement aux idees recues, la creation d'interfaces graphiques est loin d'etre une tache sim- 
ple. Pourquoi un tel constat ? L'ergonomie est une science qui n'est pas enseignee dans les for- 
mations d'ingenieurs, les architectures modernes impliquent un haut niveau de flexibility et le 
contexte de developpement (utilisation de layouts, client/serveur) est difficile. De plus, I'exigence 
des clients se porte toujours plus sur I'aspect d'une application que sur son fonctionnement reel 
et son adequation avec le cahier des charges. II est done bon de bien se persuader que tous ces 
faits contribuent a rendre ce domaine complexe et done couteux. Ainsi, l'utilisation de layouts 
dans du code client est indispensable (voir encadre sur ce sujet), mais complique terriblement le 
developpement puisque, a I'heure actuelle, aucun outil de developpement Java ne permet de 
produire un code reellement satisfaisant. On est loin des environnements comme Delphi ou 
Visual Basic, qui permettent de developper des IHM quasiment sans codage. De plus, il est preju- 
diciable d'avoir a reprendre eternellement (avec plus ou moins de succes) la problematique de 
representation de nos objets metier sous forme de composants graphiques. Certaines initiatives 
recentes, comme le projet Gatonero, permettent de creer des interfaces graphiques utilisables, 
configurables et respectant des normes ergonomiques satisfaisantes, et ce sans intrusion dans 
votre logique metier (pas de modification du code). Ce type d'approche permet de reduire les 
couts de developpement, d'eviter les bourdes ergonomiques classiques (peu d'entreprises dispo- 
sent d'ergonomes qualifies) et de realiser des applicatifs a I'aspect coherent (done non depen- 
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OUTIL Eclipse Visual Editor 



Eclipse Visual Editor permet de creer des interfaces 
graphiques AWT/Swing et SWT. Son ambition, au- 
dela de la generation d'interfaces pour le langage 
Java, est de proposer la creation d'interfaces pour 
les langages C/C++ ainsi que des ensembles de 
widgets particuliers. II est base sur le Visual Editor 
de WebSphere Studio Application Developer 5.x. 



Retour a I'application de gestion des signets 



Representation graphique envisagee : l'arbre 

A la maniere d'un explorateur Windows, notre base de donnees contenant les 
signets saisis par le personnel de BlueWeb peut etre representee comme un arbre 
du type : 




B.A.-BA Widget 



C'est un terme provenant de la contraction des 
deux mots window et gadget. Un widget est le 
nom d'un controle ou composant graphique. 



Figure 3-1 Apercu d'un arbre realise avec SWT 
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Figure 3-2 Voici un arbre plus fourni 
(avec des titres de qualite) 



Etant donnees les specifications consignees precedemment, chaque nceud 
(equivalent d'un dossier dans l'explorateur de fichiers Microsoft) est appele un 
theme, tandis qu'une feuille represente un signet. Chaque theme peut avoir de 0 
a n sous-themes, et de 0 a n signets. 

La capture d ecran de la figure 3-2 represente un cas de figure plus realiste. . . 

Choix du widget : SWT ou JFace 

JFace est une surcouche au-dessus de SWT mettant a notre disposition des 
composants plus abstraits, plus puissants et nous permettant de realiser un code 
a l'aspect plus elegant. La question du choix entre la version brute de fonderie et 
celle issue de JFace n'en est pas reellement une, car quasiment tous les compo- 
sants complexes (arbres, tables, etc.) devraient etre choisis dans JFace plutot que 
directement dans la SWT. En fait, JFace est un intermediate entre SWT et vos 
objets (du modele vous interessant). II permet done de travailler avec une abs- 
traction plus grande. 



Le TreeViewer JFace 

JFace nous fournit par le biais de ce composant un moyen de disposer dune large 
gamme de fonctionnalites integrees au sein dune architecture robuste et elegante. 
En effet, le TreeViewer nous permet de gerer des objets metier (adaptes a notre 
modele) qui nous offrent un decouplage souhaitable (pour favoriser evolution/main- 
tenance) entre l'affichage (labels, images) etles donnees (integrite, relations...). 
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Figure 3-3 

Les filtres en action dans Eclipse 
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Figure 3-4 Un projet Eclipse 
sans utilisation de filtres 
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Figure 3-5 Le meme projet 
apres application d'un filtre d'affichage 
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C'est une architecture classique en verite puisque nous retrouvons la les ele- 
ments caracterisant un design pattern repandu depuis les premieres interfaces 
graphiques en SmallTalk : Modele Vue Controleur ou MVC. 

Cet aspect classique est a rapprocher du modele dit UI (User Interface) adopte 
dans Swing, qui est finalement assez proche par la conception generate. 

Ceci a pour effet de permettre des fonctionnalites de tres haut niveau telles que les 
filtres. Dans une interface JFace, on peut cliquer sur un filtre pour ne selectionner 
que les objets de tel ou tel type (figure 3-3). Ce composant tres puissant est utilise 
massivement dans Eclipse lui-meme, comme le montrent les figures suivantes. 

Ce menu est obtenu par clic sur la fleche visible en haut a droite de l'image (a 
cote de la croix de fermeture). Ainsi, la figure 3-4 represente un projet dont tous 
les fichiers sont affiches. La figure 3-5 presente le meme projet ou Ton n'a selec- 
tionne que les fichiers .java. 

Une autre fonctionnalite avancee est la possibilite de trier le contenu de notre 
arbre suivant divers criteres ; c'est le travail de Viewers Sorters. 



. -BA MVC et modele dit UI 



Le modele UI n'est qu'une variante du MVC pre- 
sentant la particularite de regrouper en un seul et 
meme objet deux des entites definies par le MVC. 



Les acteurs 

Vbici venu le moment de detailler les differents intervenants necessaires au 
codage de l'arbre contenant nos objets metier (signets et themes) : 

• le ContentProvider, qui permet de fournir un contenu au widget (peuple 
l'arbre avec nos objets metier) ; 

• le Label Provider, qui permet d'associer images et textes aux differents objets 
de l'arbre ; 

• le TreeVi ewer, c'est-a-dire le widget en lui-meme ; 

• les objets metier (signets, themes). 



contenuDelegue 
1 




«description» 
diagramme de 
classes schematisant 
la repartition des 
responsabilites. 



«comment» 
cediagramme montre 
I'independancedu 
widget vis-a-vis 
des objets metiers. 



Figure 3-6 

Diagramme de classe UML 
schematisant les intervenants 
dans notre application 
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B.A.-BA Delegation 

Ce mot designe, dans notre contexte objet, I'utili- 
sation d'une classe tierce pour implementer une 
operation plutot que la creation d'une classe deri- 
vee. C'est un vieux debat entre partisans/adversai- 
res de I'heritage/delegation. Comme souvent, 
I'approche pragmatique vise a essayer d'utiliser les 
deux techniques a bon escient sans proscrire I'une 
ou I'autre. 



ASTUCE Analogie avec Swing 

Ces notions sont proches de celles utilisees dans 
Swing avec I'interface Renderer et I'interface 
Model. 



Ce diagramme UML de la figure 3-6 permet d'avoir une vue d'ensemble repre- 
sentative du mecanisme de delegation mis en oeuvre dans le TreeViewer. L'arbre 
est alimente en donnees par le biais du ContentProvider, les textes et icones 
directement lies aux objets metier sont issus du travail du Label Provider. On 
pourrait done, sans rien changer a notre TreeViewer, passer a une alimentation 
differente de l'arbre avec des objets metier differents ; la seule modification a 
apporter serait dans l'initialisation de l'objet TreeViewer (et non dans son code), 
via l'utilisation de deux implementations differentes des interfaces 
ItreeContentProvider et ILabel Provider. 

De I'utilite du decouplage vues/donnees 

Le codage de l'arbre aborde precedemment montre clairement les benefices 
d'un decouplage entre donnees et affichage. En effet, les problemes difficiles 
tels que le rafraichissement de vos vues sont geres automatiquement par JFace 
(comme le ferait Swing). De plus, votre code se trouve decoupe en responsabi- 
lites strictes facilitant ainsi des changements ulterieurs. 

Les filtres SWT evoques precedemment sont un bel exemple du design pattern 
Decorateur (Decorator dans l'ouvrage de reference). Ce pattern permet de 
« decorer », e'est-a-dire changer l'apparence, mais aussi les fonctionnalites 
(comme on le verra dans l'exemple suivant) d'un objet sans etre contraint de mul- 
tiplier le nombre de classes derivees. Ceci a pour but de conserver le controle 
d'une famille d'objets, car la maintenance du code d'une centaine de classes est 
beaucoup plus difficile que le meme travail applique sur une dizaine de classes. 

Ce Pattern a ete concu dans une optique d'utilisation dans un contexte gra- 
phique, dans le cas de widgets pouvant etre personnalises avec l'ajout d'images, 
de bords arrondis et autres. Cependant, il peut trouver des applications interes- 
santes dans des contextes bien differents. Ainsi, un exemple fameux d'utilisation 
de ce pattern se trouve dans le paquetage standard Java java.io, avec les classes 
Stream/Reader/Writer. En effet, ces classes sont concues pour cooperer et peu- 
vent etre emboitees telles des poupees russes, offrant ainsi une gamme de fonc- 
tionnalites bien superieures au simple nombre des classes. 

Le diagramme de la figure 3-7 montre quelques classes filles de la classe Writer 
et va nous permettre d'introduire un exemple de code tres simple illustrant la 
puissance du pattern Decorateur. 

// imports et contexte omis 

Writer writer=new BufferedWriter(new FileWriter("/tmp/out.txt")) ; 
// utilisation / fermeture etc. 

Ici, on construit un Writer, permettant d'ecrire vers un fichier de sortie. Ce 
Writer est « bufferise », done plus rapide (moins d'acces au disque). On voit 
alors que Ton obtient une « decoration » sans pour autant avoir une classe 
BufferedFileWriter. De meme, si Ton voulait ecrire vers une String, on utilise- 
rait un StringWriter en lieu et place du FileWriter. 
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Writer 

~7y 















BufferedWriter 




FileWriter 




PrintWriter 



«description» I— 1 
Extrait du package java.io 
montrant quelques classees 
derivees de la classe abstraite 
Writer 



t*. 

«comment» 

Liste non exhaustive... 



Figure 3-7 

Extrait de la hierarchie 
de Sun (paquetage java.io) 



Ce Writer pourrait etre « bufferise » en reprenant la meme construction que 
precedemment sans qu'il y ait non plus de classe BufferedStri ngWriter. Bien 
entendu, on peut emboiter differents types de Writer (sur plus de deux niveaux) 
pour obtenir ainsi une grande variete de decorations a partir d'un nombre reduit 
de classes initiales (filles de la classe Writer). 



Validation des saisies 



Pourquoi valider des saisies ? 

Dans le monde du client/serveur, encore plus que dans tous les autres types 
d'applications, les verifications des saisies utilisateur tiennent un role cle, 
puisqu'il faut imaginer que toute requete cliente fausse induira un appel reseau, 
une verification impliquant une exception metier (saisie invalide), puis en retour 
de la requete une reponse indiquant la saisie invalide. Bref, l'utilisateur peut 
avoir attendu longtemps (si le reseau est lent dans le cas d'une connexion 
modem par exemple, si le serveur est sature, etc.) pour un resultat potentielle- 
ment predictible puisque, par exemple, si Ton demande de saisir un nombre 
entier, saisir un flottant est une saisie invalide. Done, doter son application de 
tests de saisie simples ne peut que faire gagner votre application en stabilite et 
en performances puisque si Ton sollicite moins souvent le serveur, celui-ci ne 
peut que reagir plus rapidement. En effet, on fait diminuer le trafic sur notre 
reseau et on preserve la CPU du serveur. 



ARCHITECTURE Ou placer les validations ? 

Utiliser des validations des saisies clientes ne 
doit pas vous empecher de placer des controles 
de coherence dans votre logique metier. Ces 
controles ne peuvent etre qu'identiques a des 
tests effectues sur la partie cliente ou beaucoup 
plus complets suivant les cas. II s'agit surtout de 
s'assurer que les verifications effectuees sur le 
poste client ne requierent pas une trop grande 
connaissance de la partie metier, afin de reduire 
le couplage et de favoriser le developpement 
par composants. En toute logique, verifier la 
bonne saisie d'une valeur entiere, d'un numero 
de carte bleue ou encore d'une adresse de cour- 
rier electronique ne demande pas reellement de 
connaissance sur I'utilisation de cette valeur 
cote serveur. Un autre exemple pourrait etre la 
verification de la saisie d'un numero de securite 
sociale francais : sa composition est publique, 
quelle que soit son utilisation dans votre logique 
metier, et ne pas le verifier lors des saisies est 
une faille dans la logique applicative (e'est aussi 
rassurant pour l'utilisateur de se sentir guide). 
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B.A.-BA RFC (Request For Comment) 

Ce sigle peut etre traduit par « appel a 
commentaires » et date des premiers temps 
d'lnternet, une epoque ou tous les protocoles basi- 
ques (mail, FTP, TCP/IP) etaient elabores de 
maniere « artisanale » entre chercheurs passion- 
nes. Malheureusement, cette epoque est revolue, 
meme si les RFC demeurent... 



B.A.-BA EBNF 

Pour « forme de Backus-Naur etendue » : c'est la 
syntaxe habituellement utilisee pour tout ce qui 
concerne I'analyse lexicale et la creation de gram- 
maires. C'est une notation fortement liee a la theo- 
rie de la compilation, ce qui depasse notablement 
le cadre de cet ouvrage... 



B.A.-BA Expressions regulieres 

Ce terme introduit en informatique par le monde 
Unix, designe la facon de verifier la coherence 
d'une chaine avec un motif defini a I'avance (pat- 
tern). Des langages comme Perl et des outils 
comme sed, awk ou encore Emacs utilisent ces 
techniques pour offrir de stupefiantes fonctionnali- 
tes de recherche/substitution. 



OUTIL ORO 

La bibliotheque ORO est un sous-projet du projet 
Apache offert par son auteur originel (Daniel Sava- 
rese) a la communaute. Cette bibliotheque est 
rapide, performante et puissante (syntaxe AWK, 
Perl 5). 

► http://jakarta.apache.org/oro 



Dans le cas de l'applicatif BlueWeb, il s'agira de verifier que les URL saisies par 
l'utilisateur ne sont pas erronees, tout en precisant bien le contexte de notre 
verification : 

• limitee a du pattern/matching cote client (c'est-a-dire a la conformite de la 
saisie par rapport a une expression reguliere) ; 

• done pas de requete reseau type requete DNS ou HTTP ; 

• dans un premier temps, le pattern utilise ne sera qu'un garde-fou, puisqu'il 
ne s'attachera pas a respecter strictement les RFC regissant les differents 
protocoles (HTTP, FTP, etc.). 

En general, une adresse valide (URL) sera du type : 

| (Protocol e : //) ? (unechai neval i de . )+(nom_domai ne)/(URI) 

avec : 

• Protocol e : http, https, ftp (gopher et wais ne sont plus guere utilises) ; 

• unechai neval i de : tous les caracteres a-z, A-Z, 0-9, etc. ; 

• nom_domai ne : .com, .fr, .uk, .org, .net, etc. ; 

• URI : un chemin du type ti ti /toto/i mg . html 
On utilisera une syntaxe a la mode EBNF 

Comment verifier une saisie ? 

Les structures manipulees dans vos interfaces (entiers, flottants, codes, adresses, 
etc.) peuvent en majorite etre decrites de maniere generique par ce que Ton 
appelle une expression reguliere. La simple utilisation d'une bibliotheque 
d'expressions regulieres vous permet de doter votre application de fonctionna- 
lites tres avancees concernant la manipulation de chaines de caracteres. 

Lutilisation d'ORO se fait selon les etapes suivantes : 

• obtention d'un compilateur d'expressions regulieres (permet entre autre de 
verifier la bonne syntaxe de notre expression reguliere) ; 

• obtention d'un pattern a partir du compilateur et de notre expression regu- 
liere (correspondant a la verification d'une URL dans l'exemple) ; 

• verification de la chaine saisie contre le pattern via le PatternMatcher. 

DEBAT Quelle bibliotheque choisir ? 

Le grand nombre de bibliotheques dediees a cette tache nous oblige a nous poser cette question. 
Alors, entre Jakarta ORO, Jakarta Regex, le portage GNU, la bibliotheque incluse dans le JDK 1 .4 
(j ava . uti 1 . regex), laquelle faut-il choisir ? C'est un choix surement arbitraire, mais les qua- 
lites d'ORO font qu'il est difficile de migrer vers une autre bibliotheque. Quant a la nouvelle 
bibliotheque du JDK 1.4, il est regrettable que Sun ait refuse d'integrer ORO, car ce paquetage 
est moins puissant et plus restrictif que ORO. 
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Ceci peut-etre resume par le diagramme de sequence UML suivant : 



client: 



CreateAction 



I nstance: P atternC om pi I er 



compile 



CreateAction 



-> InstanceLPatternM atcher 



matches 



I 



<• 



«description» 
Utilisation d'ORO 
dans les grandes lignes 



K 



«comment» 
Enfait, le programmeur manipule des 
implementations concretes des interfaces 
PatternM atcher et PatternCompiler, telles gue 
Perl5Compiler et Perl 5M atcher pour la 
syntaxe de regexp compatible Perl 5. 



Figure 3-8 Diagramme de sequences UML schematisant I'utilisation d'ORO 

Ce diagramme simplifie quelque peu les choses, puisqu'il fait apparaitre 
PatternMatcher et PatternCompiler en tant que classes, alors qu'elles sont pro- 
posees en tant qu'interfaces dans le paquetage Oro. 

Le paquetage principal de ce produit est : org. apache. oro. text, regex. On peut 
traduire ceci par le code suivant : 

Classe de test utilisant le paquetage ORO pour la validation des saisies 

package test; 

i mport org . apache . oro . text . regex . Pattern ; 
import org . apache . oro . text . regex . Perl 5Compi 1 er ; 
i mport org . apache . oro . text . regex . Perl 5Matcher ; 

/** 

* ©author J.MOLIERE - 2003/01 

* <p> 

* une micro classe montrant comment utiliser ORO de maniere 

* a valider des cibles (URLS) sur une expression reguliere 

* esperee generique... Cette expression reguliere sera creee 

* suivant une syntaxe du type Perl 5. 

* En fait, elle est un peu trop simple pour prevenir 

* toutes les saisies erronees. 

* </p> 

V 



Interfaces 



Une interface en Java est faite pour permettre la 
prise en charge de I'heritage multiple par le Ian- 
gage, mais cet heritage multiple est un heritage de 
services (contrats, intentions) et non de code (clas- 
ses). Ainsi, il est possible d'implementer plusieurs 
interfaces mais on ne peut etendre qu'une seule 
classe (par defaut java.lang. Object). Cette 
notion d'interface permet d'imaginer de nombreu- 
ses utilisations (remplace elegamment les poin- 
teurs de fonctions chers aux adeptes du C/C++ par 
exemple) et a le merite de mettre en evidence la 
notion de services publies par un objet tout en se 
preservant de ('implementation. C'est une notion 
cle du langage qu'il faut maitriser afin de tirer plei- 
nement parti des nombreuses possibility de Java. 



Un petit programme de test des expressions 
regulieres manipulees avec ORO. 
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On peut remarquer que la syntaxe d'une expres- 
sion reguliere est quelque peu rugueuse, du 
moins au debut... 



ORO acceptant plusieurs dialectes, il faut preci- 
ser le type de compilateur a utiliser. Ici, on choi- 
sit un style Perl 5. 

ORO nous fournit un objet Pattern moyennant 
la fourniture de notre expression reguliere. 



Cet objet permet ensuite de comparer nos don- 
nees au masque generique accepte (I'expression 
reguliere). 



public class UrlTester { 
// les URLs a tester 

private static String [] cibles = {"http://amazon.com","https:// 
waba. ki ki .org" , "ftp : //a. b . com" , "ou ra/ti ti " , "http : //oura/f r"} ; 
// la regexp magique!!! 

private final static String REGEXP = "(A(http| ftp | https | file) :// 

)?(\\S+\\ ■ )+(net | org | f r | uk | com | de) (/(\\S)+)?" ; 

/** 

* la methode main 

V 

public static void main(String[] args) throws Exception{ 
// on utilisera une syntaxe compatible Perl 5 
// d'ou cette implementation du PatternCompiler 

Perl 5Compi ler compiler = new Perl 5Compiler() ; 



// obtient le Pattern grace au compilateur 
Pattern pattern = compi ler. compile (REGEXP) ; 

PerlSMatcher matcher = new Perl 5Matcher() ; 

// itere sur les cibles 

for(int i = 0;i < cibles. length;i++){ 

boolean result = matcher. matches (cibles[i] .pattern) ; 

System. err. println(cibles[i] + " matchee ? = "+ result); 

} 

} 

} 

Soit une sortie sur la console (apres execution de java test. UrlTester) : 

http://amazon.com matchee ? = true 
https://waba.kiki.org matchee ? = true 
ftp://a.b.com matchee ? = true 
oura/titi matchee ? = false 
http://oura/f r matchee ? = false 

Une seule pseudo-URL n'est pas reconnue comme valide, ce qui est normal 
etant donne la syntaxe de notre expression reguliere et l'URL testee. En packa- 
geant un peu notre code, on peut obtenir l'extrait suivant : 

He version de la classe de test des saisies d'UF 



elle vers 



package com . bl ueweb . bookmarks . tool s ; 

i mport org . apache . oro . text . regex . Mai f ormedPatternExcepti on ; 

i mport org . apache . oro . text . regex . Pattern ; 

i mport org . apache . oro . text . regex . Perl 5Compi ler; 

i mport org . apache . oro . text . regex . Perl 5Matcher ; 

/** 

*<p> 

* Ce composant permet de tester la validite d'une URL. 

* Bien sur, la validite des tests qu'il effectue depend 

* essentiellement de I'expression reguliere, done plus celle-ci 

* sera complete, meilleures seront ses reponses. 
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* </p> 

* <p> 

* Notre composant est tres simple et ne propose qu'un seul service 

* isValidURLO 

* </p> 

* ©author Blueweb - 2003/01 

*/ 

public class UrlTester { 

private static Perl5Compiler compiler; 
private static Perl5Matcher matcher; 
private static Pattern pattern; 

private final static String RECEXP = "(A(http | ftp | https | file) :// 
*)?(\\S+\\ . )+(net | org | f r | uk | com | de) (/(\\S)+) ?" ; 

static{ 

compiler = new Perl 5Compiler() ; 
matcher = new Perl 5Matcher() ; 

try{ 

pattern = compiler. compile (RECEXP) ; 

} 

// oops ! quelqu'un a touche a la string RECEXP 
// inutile de continuer , jette une RuntimeException 
catch (Mai formedPatternExcepti on e){ 

throw new RuntimeException("Bad Pattern for URL testing"); 

} 

} 

/** 

* <p> 

* Teste une URL (anURL) contre la regexp general e 

* </p> 

* @param anURL, String contenant l'URL a tester 

* ©return true, si l'URL est valide, false autrement 

V 

public static boolean isValidURL(String anURL){ 
return (matcher. matches (anURL, pattern)) ; 

} // isValidURLO 

} 

Void une sortie de la console Java mettant en evidence une modification ren- 
dant incorrecte l'expression reguliere, ce qui se traduit par une 
Mai formedPatternExcepti on levee au moment de l'appel a la methode compile 
de Perl 5Compi 1 er pendant le chargement de la classe. Avec une telle solution, il 
est impossible de passer a cote d'un tel probleme pour le composant (et il ne 
vaut mieux pas). 

java.lang.Exceptionlnlnitializer Error 

Caused by: java.lang. RuntimeException: Bad Pattern for URL testing 

at com. bl ueweb. bookmarks. tool s.Url Teste r.<clinit>(Url Teste r.java: 37) 
Exception in thread "main" 



< Utilise un bloc statique pour ('initialisation des 
matcher et compiler. Ceci permet de gagner en 
rapidite plutot que de refaire a chaque appel les 
memes initialisations, ainsi que de jeter une 
exception des le chargement de la classe si Ton 
a modifie la chaine regexp en la rendant incor- 
recte (au sens de la grammaire Perl 5). 
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Maintenance du code : le framework JUnit 



OUTIL JUnit 



JUnit est un outil issu d'une des obsessions de 
I'eXtreme Programming : le test. II fournit un fra- 
mework elegant et leger, simple de mise en oeuvre 
et permettant d'operer des tests unitaires sur des 
composants. II est disponible a I'URL suivante : 
http://www.junit.org. A ce jour, la derniere version 
disponible est la 3.8.1. 



POUR ALLER PLUS LOIN JUnit 

Le JUnit Cook book doit vous permettre de bien 
demarrer avec JUnit. II est fourni avec d'autres 
documents dans le .zip de la distribution JUnit. 
► http://junit.sourceforge.net/doc/cookbook/ 
cookbook.htm 



Comme le bout de code precedent le montre, les expressions regulieres consti- 
tuent un outil d'une grande puissance, mais leur syntaxe hermetique en fait des 
proies faciles pour les petits bogues insidieux. Enlevez le caractere a par suite 
d'une erreur de frappe ou d'un mauvais copier/coller et votre composant accep- 
terait des URL du type : que_faisJeJa_http://w3.org. 

C'est relativement problematique et l'equipe BlueWeb ne peut qu'avoir cons- 
cience d'un tel probleme. II s'agit done de doter notre composant en charge des 
validations de saisie de garde-fous nous protegeant de ce que Ton appelle les 
bogues de regression. Cela signifie qu'il nous faut faire en sorte qu'une fois notre 
compose « package », nous nous assurions que les fonctionnalites presentes en 
version 1 continuent de marcher a chaque nouvelle version. II s'agit de ne pas 
revenir en arriere. II s'agit la bien sur de simples tests unitaires, e'est-a-dire de 
tests operes dans un contexte reduit au seul composant. 

Pour mettre en oeuvre ce framework, il suffit de respecter les etapes suivantes : 

1 Creer une classe de test heritant de junit.f ramework.TestCase (nommer 
cette classe en suffrxant par Test le nom de votre classe a tester). 

2 Creer une suite de tests comprenant au minimum votre classe de test nou- 
vellement creee. 

3 Lancer un des runners JUnit parmi les trois disponibles (mode console, 
mode graphique ou integre a Ant via la task JUnit). 

La classe de test doit etre codee selon le schema suivant : 

1 Constructeur acceptant une chaine de caracteres. 

2 Creer au moins une methode testXYZ pour chaque methode publique de la 
classe a tester. 

3 Creer eventuellement une methode setUpO initialisant des ressources mani- 
pulees dans les methodes testXYZ. 

4 Creer eventuellement une methode tearDownO liberant des ressources 
manipulees dans les methodes testXYZ. 

Tout de suite, void le code permettant de tester notre composant de verification 
des URL. 



Classe de test permettant de valider unitairement le code precedent.. 

package com . bl ueweb . bookmarks . tool s ; 
import j unit. framework. Test; 
import junit.f ramework.TestCase; 
i mport j uni t . framework . TestSui te ; 

*<p> 

* La classe de test attachee a la classe UrlTester. 

* Ici , 1 'importance des noms de classe prend tout son sens 
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* puisque "Ton voit a quel point UrlTester est un nom mal choisi 

* On utilise le framework DUnit. 

* </p> 

*/ 

public class UrlTesterTest extends TestCase { 

// rien a f ai re dans notre cas 

// mais c'est ici que l'on pourrait ouvri r un fichier ou une 
// connexion BDD utilisee dans notre test 
protected void setl)p(){ 
} // setUpO 

// rien a fai re ici 

// mais c'est ici que l'on pourrait fermer un fichier ou une 
// connexion BDD utilisee dans notre test 
protected void tearDown(){ 

} // tearDownO 

/** 

* <p> 

* ce constructeur permet d'afficher quel test echoue 

* </p> 

*/ 

public UrlTesterTest(String aName){ 

super(aName) ; 
}//constructor() 

/** 

* <p> 

* c'est la methode permettant de tester le seul service 

* de notre classe UrlTester 

* attention au nom! ! 

* </p> 

*/ 

public void testIsValidURL(){ 

assertTrue) ; 

} // testlsValidURLO 

/** 

* <p> 

* construit la suite de tests a derouler... 

* ici on utilise la methode basee sur 1 'introspection lava 

* sympa pour les faineants... 

* </p> 

*/ 

public static Test suite(){ 

return new TestSuite(UrlTesterTest. class) ; 
} // suiteQ 



II ne reste plus qua lancer le test (voir figure 3-9). 



On doit verifier que isValidURL renvoie bien 
vrai pour une URL valide comme celle du noyau 
linux. Bien entendu, un test plus significant 
prendrait en compte different^ protocoles (ftp, 
https), differents types d'URL, des URI. Bref, il 
suffit d'ajouter des assertEquals. Evidement 
on peut inclure des tests renvoyant f al se. 



59 



QJUnit 



nop 



B.A.-BA Programmation par contrat 
(DBC, Design By Contract) 

Contraction anglaise pour Design By Contract, ou 
programmation par contrats en francais. C'est un 
concept introduit par un des gourous de I'objet, le 
francais Bertrand Meyer, auteur du langage objet 
Eiffel. II s'agit d'insister sur le fait qu'un deve- 
loppeur publiant son API passe un contrat entre 
lui-meme et I'utilisateur de son API. En effet, il 
propose des services valables dans un certain 
contexte ; hors de ce contexte (le contrat est 
rompu), il ne garantit plus le fonctionnement. 
Bertrand Meyer introduit la notion d'assertions, 
verifications de tests induisant des reponses a 
VRAI ou FAUX. Ces assertions peuvent etre de 
trois types : les pre-conditions, les post-conditions 
et les invariants. C'est un domaine passionnant, 
mais qui une fois encore depasse le cadre de 
I'ouvrage. Plus d'informations sont disponibles sur 
le site de la societe ISE commercialisant Eiffel : 
► http://www.eiffel.com. 



Test class name: 

com. blueweb. bookmarks. tools. IJMTestetTest | •yj | ... | Run 

E Reload classes every run 





Runs: 1/1 


x Errors: 0 


Failures: 0 




Results: 








a. 


<r^ ih i 


1 x Failures fjfr Ten HlerarehTT" 








a. 


<l 









Run 



| [Finished: 0,075 seconds Exit 

Figure 3-9 Execution de notre test unitaire avec le programme fourni avec JUnit 

Cette capture d'ecran presente le lancement du runner graphique Swing JUnit. 
Pour le lancer, il suffit de saisir la ligne suivante dans une console : 

java junit.swingui .TestRunner 

com . bl ueweb . bookmarks . tool s . UrlTesterTest 

Les tests unitaires en pratique 

Une pratique pronee par XP semble d'abord etrange, puis se revele logique : 
c'est le commandement de Ron Jeffries : commencer par coder les tests. Surpre- 
nant en effet, mais c'est une pratique tres saine puisque, avant de coder un com- 
posant, il est souhaitable de connaitre les services qu'il va proposer et done d'etre 
a meme de fixer les differents contrats (au sens de la programmation par contrat 
(DBC) de Bertrand Meyer). 

Si Ton connait le contrat offert par un service, pourquoi ne pas commencer par 
coder la classe de tests qualifiant ce composant ? Ce point est reellement un des 
elements importants mis en evidence par XP. 

De plus, l'importance de l'automatisation des tests implique au sens XP que 
100 % des tests passent, et ce pour tous les composants. Ce point entend l'inte- 
gration du lancement de nos tests via un outil de make type Ant, de facon a ne 
pas reposer sur l'intervention humaine, mais au contraire sur un caractere syste- 
matique. Si Ton ecrit du code de test, ce n'est pas pour qu'il soit ignore. . . 
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L'outil le plus simple pour realiser cette integration reste l'utilisation de la tache 
DUnit dans Ant. Pour illustrer l'usage de cette tache sur le composant de valida- 
tion d'URL, rien de tel qu'un petit build f i 1 e dedie a cette tache. 

Script ANT lancant I'execution du jeu de test presente prece 



<project name="BlueWeb" default="mai n" basedir="."> 



<property name="src" location^" . "/> 
<property name="build" location="bui ld"/> 
<property name="reports" location="reports"/> 
<property name=" reports . html .di r" location="${reports}/html"/> 
<!-- initialisation --> 
<target name="init" 

description ="creee les repertoires utilises par la suite"> 
<!-- utilise la task mkdir pour creer les repertoires — > 
<mkdi r di r="${reports}"/> 
<mkdi r di r="${reports . html .di r}"/> 
<mkdi r di r="${build}"/> 
</target> 

<target name="compile" depends="init" > 
<javac srcdir="${src}" destdi r="${build}" 

i ncl udes="com/bl ueweb/bookmarks/tool s/* . java"/> 

</target> 

<target name="clean" description="prepare le grand menage... "> 

<delete di r="${reports}"/> 

<delete di r="${build}7> 
</target> 

<target name="test" depends="compile"> 

<junit printsummary="yes" fork="yes" haltonfailure="yes" > 
<formatter type="xmT' /> 
<classpath> 

<pathelement location="${build}"/> 

<pathel ement path="${java.cl ass . path}"/> 
</cl asspath> 

<test name="com . bl ueweb . bookmarks . tool s . Url TesterTest" 
todir="${reports}"/> 

</junit> 

<junitreport todir="${reports.html .dir}"> 
<fileset dir="${reports}"> 

<include name="TEST-*.xml"/> 
</fileset> 

<report format="noframes" todir="${reports.html .dir}"/> 
</junitreport> 

</target> 

<!-- target principale (par defaut) --> 
<target name="main" depends="test" > 
</target> 
</project> 



Cree un projet BlueWeb dont la cible par defaut 
s'appelle « main » et positionne le repertoire par 
defaut sur le repertoire courant. 



Positionne quelques proprietes telles que le 
repertoire source, les repertoires utilises pour le 
stockage des classes compilees et des rapports. 



Ici on supprime les 2 repertoires ou sont stockes 
les resultats de ce build (classes et rapports). 



C'est la « target » (cible) qui nous interesse ; elle 
va invoquer les deux « tasks » JUnit et JUnitRe- 
port de maniere a realiser I'execution et un rap- 
port sur ce lancement. 



Ici, on veut stacker le rapport HTML dans le 
repertoire precise. On utilise une presentation du 
type NOFRAMES pour interdire la production de 
pages Web avec des frames (car Lynx ne les 
prend pas en charge). 



CONSEIL Installation 

Attention, reportez-vous a la section du manuel 
Ant relative aux optional tasks pour une refe- 
rence sur la maniere de modifier votre configu- 
ration pour utiliser les taches optionnelles 
lunit et JunitReport. 
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L'execution de ce code doit produire un rapport (voir figure 3-10). 



■3 




Packages 








Note: package statistics ore not computed recursively the* only s 


um up all of its testsurtes numbers. 










Failures 


1lme(>) 




1 0 
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Package com. blueweb. bookmarks. tools 






1 0 




0.713 


r-i.-t f ■■ — 
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Figure 3-10 Rapport HTML delivre par JUnit et la task style de ANT 



Integration des tests unitaires dans le cycle de vie du logiciel 

II faut rappeler ici quelques-uns des grands principes {best practices) permettant 
de tirer le meilleur parti de l'utilisation d'un framework de tests unitaires : 

• II est bon de coder les classes de test avant meme de coder les objets a tester. 
Pourquoi ? Car cela lie fortement cette pratique avec la phase de conception 
et permet d'eviter la phrase rituelle : « je le ferai plus tard ». Non, il faut inte- 
grer les tests unitaires dans la phase de codage et le fait de les integrer de 
bonne heure (avant le codage meme des composants a tester) permet d'etre 
sur ne pas les « oublier ». 

• II est imperatif de rendre l'execution de ces tests automatique et indissocia- 
ble de votre processus de generation de livrables (code, paquetages). Pour 
cela, la task ANT JUnit est l'outil reve. 

• II est important de coder ces scripts ANT de maniere a ce que toute erreur soit 
sanctionnee par l'arret du processus de build. En effet, si on a l'opportunite 
de detecter un probleme rapidement, il faut faire en sorte de le regler rapide- 
ment. 
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Si les deux derniers points trouvent des solutions pratiques dans les scripts et la 
documentation de la tache DUnit, comment faire pour integrer en douceur JUnit 
dans votre travail quotidien ? 

Une solution reside dans une integration tres precoce en faisant en sorte de 
generer vos suites de tests par votre outil de modelisation (AGL). En effet, des 
outils comme Objecteering de Softeam (disponible via l'URL http://www. 
objecteering.com) permettent de modeliser puis generer le code de vos tests. 
Comment ? Eh bien ! regardons cela... 

Placons-nous dans le contexte simple d'un paquetage reduit a une seule classe, 
un convertisseur euro (done une mini-calculette fort utile pour retrouver nos 
marques depuis le changement de monnaie). 

Ce n'est rien de plus qu'une classe fournissant un constructeur et des methodes 
de conversion (franc vers euro et euro vers franc). 

Maintenant, grace au module de tests pour Java, nous pouvons definir une 
situation de test sous la forme d'un diagramme de sequences UML. Ainsi, pour 
notre exemple, avec un convertisseur, on peut modeliser cela sous la forme de la 
figure : 



aMainTcster;MainTeacr 



creat<6 55957f) 



* aC oiwertcr : :t ea : converterT estSuit e 1 : Convert a 



euroToFrancs(2) 



— 

-5 



Converter 



rate : real 



«create» 
create() 
ftancsToEuros() 
euroToFrancsO 



Figure 3-11 Classe de convertisseur euro 
modelisee avec UML 



«descnption» ^ 
Dcscnptionofthe 
test: 



«assert» L\ 

?— n.iif 



Figure 3-12 

Diagramme de sequence synthetisant 
le test d'une fonctionnalite de conversion 
(euro vers franc) 



Soit, en paraphrasant le diagramme illustre sur la figure 3-12 : 
• On cree l'objet convertisseur en passant en parametre le taux de la conver- 
sion (flottant 6.55957). 
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Ea 
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S3 

a 

ci 

Si 



fel DemoTestsForJAVA 
B-fel softeam |\ 

Izl-^ Converter 
j ■■■■ [a^1 +rate : real 
^■■loOl+createfln rate: real) 
B"|oO] +francsToEuros(ln toConveit:ieal 
[i]"[oOl +euroToFrancs(ln toConvert:real):i 

test 

IzJ--^ converterTestSuitel 
I-- fel packages tub 
[jj- [j^ content 

[j^ primitiveTestsContext 
f^J Converter 



J JJ 



Figure 3-13 Vue d'un test unitaire au sein 
d'Objecteering, module de test 



Bien entendu, cette phase est facilitee par la pre- 
sence d'assistants... 



• On compare le montant obtenu en convertissant 2 euros en francs avec la 
valeur de reference (ici 13.11). 

Le projet vu dans l'outil est du type montre a la figure 3-13 qui illustre com- 
ment, a partir d'un composant a tester, on peut obtenir une suite de tests. 

A defaut de pouvoir etre exhaustive (il ne s'agit pas de se substituer a la docu- 
mentation de ce produit), le but de cette section etait de montrer un moyen 
d'integrer elegamment la creation de tests unitaires dans votre projet. Pour cela, 
quoi de mieux dans l'esprit que le produit contenant la modelisation de votre 
projet. Ainsi, vos cas de tests seront partie integrante de la documentation 
generee depuis le produit et ainsi les eventuels problemes de mauvaise compre- 
hension seront supprimes. En effet, etant donne la simplicite des diagrammes 
de sequence (simplicite necessaire), les chances de mauvaise interpretation des 
fonctionnalites (testees) seront tres faibles. L'utilisation d'une telle approche 
permet de plus de reduire la phase un peu laborieuse et repetitive de codage 
inherente au framework JUnit. Nous avons alors adopte une demarche pragma- 
tique permettant de reduire le risque d'erreurs et d'ameliorer la productivite. 
Cette attitude est appelee en japonais « kaizen » comme le rappellent dans leur 
ouvrage les auteurs de Pragmatic programmer : from journeyman to master : 
essayer de prendre le recul necessaire a l'analyse permanente de notre travail de 
maniere a trouver des petites astuces ou outils nous permettant de le realiser 
mieux et plus vite. 



OUTIL Artima et TestNG 

II peut etre interessant de mentionner Artima Suite 
Runner pouvant completer avec grand benefice 
JUnit. Ce produit est ne de I'experience concrete 
de Bill Venners (auteur du meilleur ouvrage dispo- 
nible sur la machine virtuelle Java) avec JUnit. 
Le lecteur plus curieux s'interessera a TestNG ecrit 
par Cedric Beust qui prefigure peut-etre I'avenir 
des tests unitaires avec son framework a base 
d'annotation. 

► http://www.artima.com 

► http://www.beust.com/testng/ 
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Nous ne detaillerons pas les multiples possibility offertes par le module dedie aux tests d'Objec- 
teering, qui peut meme automatiser la packaging et le deploiement de vos composants au sein 
d'une instance de Cactus. Rappelons simplement en passant que Cactus est aussi un sous-projet 
du projet Jakarta et qu'il vise a fournir un framework generique pour les differents types de tests 
unitaires sur des composants serveurs. 
► http://jakarta.apache.org/cactus/index.html 



Cette section nous a permis d'evoquer les fondements de l'utilisation du fra- 
mework JUnit et de proposer une facon de l'integrer en douceur dans vos projets. 



Gestion des traces applicatives 

L'approche adoptee par BlueWeb est resolument pragmatique, issue de I'expe- 
rience tiree d'annees de developpement avec differentes technologies. BlueWeb 
a pleinement conscience que le corollaire d'une demarche utilisant des tests uni- 
taires est l'utilisation de traces applicatives permettant de resoudre les conflits 
avec les clients, d'accelerer les procedures de correction d'erreurs en enlevant la 
place au doute. En effet, une trace bien faite doit permettre de suivre etape par 
etape le chemin de l'utilisateur jusqu'a l'erreur qu'il signale. Meme un projet 
aussi modeste que celui de BlueWeb reclame l'utilisation d'une bibliotheque de 
gestion des traces (logs ), ce qui par ailleurs constituera un plus a ajouter a l'actif 
de l'equipe. 
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Kernighan et Pike utilisent des traces plutot que des outils de debogage pour les 
raisons suivantes : 

• la facilite avec laquelle on peut etre perdu dans des structures complexes lors 
de sessions de debogage ; 

• le manque de productivite de ces outils par rapport a une solution manipu- 
lant avec justesse des traces de controle ; 

• l'aspect persistant des traces par rapport a des sessions de debogage. 

Pourquoi ? me direz-vous. L'utilisation de System. out. printlnO ou 
System. err. printlnO permettant d'afficher des messages dans la console de 
sortie et dans la console d'erreur (generalement la console MS-DOS ou la boite 
shell utilisee pour lancer l'application) s'avere largement insuffisante, et ce pour 
differentes raisons : 

• manque de rapidite de la solution (solution excessivement couteuse en 
ressources) ; 

• manque de souplesse (trop figee). 

En effet, il est indiscutable qu'une utilisation de traces via des 
System . out . pri ntl n est tres lente, mais le point crucial reside dans le manque de 
souplesse de la solution lorsqu'on veut : 

• supprimer certaines traces (celles correspondant a du debogage doivent etre 
supprimees avant un passage en production) ; 

• aj outer des traces (pour traquer un bogue) ; 

• creer un nouveau fichier contenant une partie des traces (de maniere a sepa- 
rer en plusieurs fichiers des traces volumineuses) ; 

• communiquer avec un serveur de traces (dans le cas d'une application en 
reseau, en utilisant des services du type syslog sous Unix ou le service d'eve- 
nements de Windows) ; 

• modifier le format de la totalite ou d'une partie des traces (suite a une 
demande emanant de clients). 

Tous ces problemes, BlueWeb les a connus et cherche done un moyen pour les 
occulter avant meme qu'ils ne surgissent. II s'agit pour l'equipe d'adopter un fra- 
mework pouvant repondre a tous ces besoins. Pour cela, il n'y a rien de tel 
qu'une recherche sur Internet pour connaitre l'etat de l'art. . . 



ESSENTIEL Traces 

N'utilisez pas les System. err. printlnO et 
autres System. out. printlnO, cela pollue 
le code, ralentit l'application et pose des proble- 
mes une fois deploye chez un client. 



Log4J ou java.util. logging ? 

Ecartons d'emblee, comme l'a fait BlueWeb, la possibility de creer son propre 
framework dedie aux traces, et ce pour les sempiternelles raisons : 

• tache ardue et longue ; 

• cout eleve pour la societe ; 

• pourquoi reinventer la roue ? Fjgure 3 _ 14 LogQ du projet Log4J 
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Pour ceux qui ne trouvent pas ici les arguments 
leur permettant de faire ce choix, voir la page web 
suivante pour des elements de comparaison sup- 
plemental. 

► http://www.qos.ch/ac2001/F1 1-200.html 



Quelles sont alors les solutions envisageables dans ce domaine ? Le nombre de 
solutions existantes est tres important, mais en y regardant de plus pres, les pro- 
jets utilisent en majorite une bibliotheque Log4J. 

Log4J est une bibliotheque faisant partie du projet Jakarta (http://jakarta.apache.org/ 
log4j). Elle brille par diverses qualites, notamment sa simplicite d'utilisation, ses 
bonnes performances, sa conception elegante la rendant a la fois souple et evolu- 
tive et le fait quelle soit tres parametrable. II s'agit presque d'un standard de 
facto. 

D'un autre cote, on peut remarquer qu'avec la nouvelle plate-forme (JDK 1.4), 
Sun a integre un framework de trace (paquetage java. uti 1 . 1 oggi ng). Si Ton ne 
peut que se rejouir d'une telle demarche, il faut quand meme constater que 
celui-ci presente de severes limitations : 

• il a moins de fonctionnalites ; 

• il peut necessiter du codage pour obtenir des fonctionnalites deja presentes 
dans Log4J ; 

• l'API Sun est maintenue par Sun, tandis que Log4J evolue grace a la com- 
munaute qui l'utilise. 

De plus, le passe de Log4J ne fait que jouer en sa faveur, puisque c'est une 
bibliotheque utilisee par de nombreux developpeurs depuis plusieurs annees. 

Ce choix n'est pas evident etant donnee la qualite des competiteurs, mais pour 
BlueWeb la decision est prise, car, par souci de coherence avec ses autres choix, 
l'equipe ne peut rester insensible aux arguments du produit utilise dans : 

• Tomcat ; 

• JBoss. 

Cela sera done Log4J. 

Log4J : concepts 

Log4J propose une separation stricte entre l'insertion d'une trace de log, la des- 
tination de cette trace (fichier, socket) et le format de l'affichage de cette trace, ce 
qui nous permet de repondre a la majeure partie des contraintes dictant notre 
choix. La seule question encore en lice reste celle des performances... 

La configuration des logs est faite via un fichier XML ou, plus classiquement, 
via un fichier .properties (associations cle/valeur), mais nous y reviendrons 
plus tard. 

Le vocabulaire necessaire a l'utilisation de Log4J se resume aux mots suivants : 

• Logger. Cette classe (et ses classes filles) permet d'autoriser ou non diffe- 
rents niveaux de trace. Le programmeur va utiliser une instance de cette 
classe pour demander l'insertion d'une trace en precisant le niveau requis 
(debug, info, warn, error, fatal, classes suivant leur ordre d'importance 
croissante). 



66 



• Niveau d'une requete. Sachant que les demandes d'insertion de trace sont 
classees par ordre, si Ton choisit d'autoriser les requetes de type warn, toutes 
les demandes faites avec les niveaux debug et info seront ignorees (jetees) 
tandis que les autres seront redirigees vers le bon Appender. 

• Appender. C'est le nom de la classe modelisant dans l'architecture Log4J 
l'objet chargeant l'ecriture des logs vers le ou les flux (socket/fichier, etc.) 
adequats. 

• Layout. Nom de la classe modelisant l'objet en charge de la presentation 
(format) des messages. 

• Configurator. Cette classe permet d'initialiser le dispositif de logs pour 
toute une application (il n'y a done qu'un seul appel par application). 

Ce vocabulaire acquis, on peut tenter d'illustrer par un diagramme de sequences 
UML l'utilisation typique de ce produit (voir figure 3-15). 




lnstance3:Lavout 



{si niveau < 
niveau minimum} 

detruitRequete 



^Hr> messageAutorise 


{si niveau >= ^ 
niveau autorise} 









CreateA ction 



lnstance2:Appender 



u 



:u 

i 
i 
i 
i 
i 
i 

' ! 

Figure 3-15 Utilisation d'un produit de gestion des traces (diagramme de sequences UML). 

Ce diagramme schematise l'utilisation typique de Log4J, en caracterisant la ges- 
tion des niveaux de messages et les interactions entre les differents acteurs. Mais 
en pratique, l'utilisation est beaucoup plus simple, comme le montre l'exemple 
suivant. 



1} 
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Les imports necessaires a notre programme, ici 
reduits a nos dependances envers Log4J. 



Une petite classe demontrant I'utilisation basi- 
que de Log4J. 



La traditionnelle methode man n () . 



Configure le systeme de logs avec les options 
par defaut : il faut un des configurator une fois 
par application. Attention : ceci n'a pas besoin 
d'etre fait une fois par classe. 



Obtient un Logger. 



Ajuste le niveau desire : ici on selectionne le 
niveau WARN, done tous les messages de niveau 
DEBUG et INFO seront abandonnes. 



Positionne 2 traces qui ne seront pas affichees 
dans I'appender par defaut (la console). 



Celle -ci doit etre affichee. 

On s'en va, alors on salue... L'utilisation d'un 
niveau FATAL pour cela est un peu abusive... 



Exemple d'utilisation de Lo 

package test.log4j ; 

import org. apache. log4j .BasicConfigurator; 
import org. apache. log4j .Level ; 
import org. apache. log4j .Logger; 

public class Log4j Exemple { 

public static void main(String[] args) { 
BasicConfigurator. configure () ; 



Logger logger = Logger. getLogger(Log4]Exemple. class) ; 

// peut aussi etre obtenu par le passage du nom du paquetage 
// Logger logger = Logger . getLogger ("test . 1 og4 j ") ; 

logger . setLevel (Level .WARN) ; 



logger. debug("on ne doit pas voir ce message"); 
logger. info("celui-ci non plus!!"); 

logger. warn("en revanche, celui-la doit etre affiche"); 

// fait quelque chose 
logger. fatal ("au revoir!!"); 



} 



} 



L'execution de cette classe, via java test. 1 og4 j .Log4j Exemple, donne la sortie, 
dans la console Eclipse, de la figure 3-16. 



□ [main] WAPN test. log4j . Log4j Exemple 
J [main] FATAL t es t . Iuci4] . LdlH i Exeinp le 



par contre celui la doit etre affic^ 
- au revoir ! ! 



Figure 3-16 Console Java d'Eclipse contenant la sortie du programme de test des traces 

Poursuivons sur un autre exemple un peu plus complexe, puisqu'il permet 
d'introduire un autre Configurator, celui permettant d'utiliser comme source de 
donnees un fichier properti es Java. II permet de plus de montrer comment uti- 
liser plusieurs appenders (ici, l'un envoyant les messages vers la console, l'autre 
vers un fichier tournant). 



Utilis 



plusieurs sorties 



package test.log4j ; 

import org. apache. log4j .Logger; 

import org. apache. log4j .PropertyConfigurator; 
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public class Log4jExempleAvance { 
private static Logger logger = 

Logger . getLogger (Log4 j Exempl eAvance . cl ass) ; 

private static class Toto{ 
public void foo(){ 

// faire quel que chose d' utile !!! 

} 

} 

public static void main(String[] args) { 

// teste que l'on ait bien saisi un nom de fichier (un argument) 
if (args. length <1){ 
usage(); 

} 

PropertyConfigurator.configure( args[0]) ; 

Toto toto = new Toto(); 
logger. debug("toto instancie") ; 
toto. f oo () ; 

logger. info("foo() invoquee") ; 

logger. warn("fini ! ! ") ; 

} // main() 

private static void usage(){ 

System. err .pri ntln("Mauvai s usage ! ! ") ; 

System . e r r . pri ntl n (" j ava test . 1 og4 j . Log4 j Exempl eAvance 
<fichier de configuration") I 

System. exit(255) ; 
} // usage() 

} 

Voici le fichier de configuration (log . properties) correspondant : 

# ici on utilisera plusieurs appenders 

# un de type console, un autre sous la forme d'un fichier tournant 
log4j.rootl_ogger=DEBUG, CON, ROLL 

# CON est un appender du type console 

1 og4j . appender . CON=org . apache . 1 og4 j . Consol eAppender 

1 og4j . appender . CON . 1 ayout=org . apache . 1 og4j . PatternLayout 

# definition du formatage des messages 

log4j .appender. CON. layout. ConversionPattern=[%t] %-5p %c - %m%n 

# on n'affichera que les messages du niveau WARN ou superieur 
log4j .logger. test. log4j=WARN 

# ici ROLL est declare comme un buffer de taille 

# maximale lOkb , on conserve 2 copies. 

# le fichier est sauve sous le nom rolling.log 

log4j . appender . ROLL=org . apache . log4j . Rol 1 i ngFi 1 eAppender 
1 og4 j . appende r . ROLL . Fi 1 enroll i ng . 1 og 
1 og4 j . appende r . ROLL . MaxFi 1 eSi ze=10KB 
1 og4 j . appende r . ROLL . MaxBackupIndex=2 

1 og4j . appender . ROLL . 1 ayout=org . apache . 1 og4 j . PatternLayout 
log4j .appender. ROLL. layout. ConversionPattern=%d %-5p %c - %m%n 



< Usage un peu plus avance de Log4J via un fichier 
de configuration et done le configurator associe 
(PropertyConfigurator). 



< La methode main sera appelee avec un argu- 
ment : le nom du fichier de configuration utilise 
pour les logs. 
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Avec ce fichier de configuration, on obtient une sortie console du type de celle 
de la figure 3-17. 




Figure 3-17 Console Java d'Eclipse, montrant I'effet de notre configuration de Log4J 

Vbici un autre exemple, dans lequel on a modifie un seul parametre dans ce 
fichier de configuration : 



Fichier de configuration de Log4j (format .prop 

# ici on utilisera plusieurs appenders 

# un de type console, un autre sous la forme d'un fichier tournant 
log4j . rootl_ogger=DEBUG, CON, ROLL 

1 og4 j . appender . C0N=o rg . apache . 1 og4 j . Consol eAppende r 

1 og4 j . appender . CON . 1 ayout=org . apache . 1 og4 j . PatternLayout 

# definition du formatage des messages 

log4j .appender. CON. layout. ConversionPattern=[%t] %-5p %c - %m%n 

# on n'affichera que les messages du niveau WARN ou superieur 
log4j .logger. test. log4j=DEBUC 

1 og4 j . appender . R0LL=org . apache . 1 og4 j . Rol 1 i ngFi 1 eAppender 
log4j .appender .ROLL. Fi le=rolling. log 
1 og4 j . appender . ROLL . MaxFi 1 eSi ze=10KB 
1 og4 j . appender . ROLL . MaxBackupIndex=2 

1 og4 j . appender . ROLL . 1 ayout=org . apache . 1 og4j . PatternLayout 
log4j .appender. ROLL. layout. ConversionPattern=%d %-5p %c - %m%n 



REFERENCE Log4J Manual 



Pour tous les programmeurs curieux d'en savoir 
plus sur ce produit, on ne peut que conseiller chau- 
dement la lecture du livre de I'auteur de ce produit 
Ceki Gulcu : Log4J Manual, disponible sur le site de 
I'auteur de Log4J (version ebook payante). 
► http://www.qos.ch 



On obtiendrait une sortie de la forme suivante (figure 3-18) : 



[main] DEBUG test . log4j . Log4 jExempleAvance 
[main] INFO test. log4j .Log4 jExempleAvance 
[main] WARN test . log4j . Log4 jExempleAvance 



toto instancie 
f oo ( ) invoquee 

f ini ! ! 



id 



Figure 3-18 Observez bien I'effet du changement de configuration sur la sortie dans la 

console Eclipse 



Voila de quoi terminer notre parcours rapide des possibilites de cette excellente 
bibliotheque quest Log4J. 
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En resume 



Ce chapitre a permis d'introduire SWT et JFace, les API du projet Eclipse 
dediees au developpement d'applications graphiques. De plus, il nous a donne 
l'occasion d'aborder le probleme du controle des saisies utilisateur tout en intro- 
duisant la notion de tests unitaires et la notion corollaire de bibliotheque de ges- 
tion des traces applicatives. On peut remarquer qu'il s'agit ici d'introduire des 
pratiques saines et des outils de qualite plus que de realiser une application. . . 
En effet, l'accent est mis sur la reutilisation de composants courants, ce qui doit 
etre la preoccupation permanente au sein d'une equipe. 
Pour aller plus loin avec ce morceau d'applicatif, il faudrait : 

• completer l'expression reguliere utilisee (une recherche sur Internet devrait 
vous mener vers des pistes serieuses) ; 

• ameliorer le nombre de verifications effectuees dans la methode 
testlsValidURLO, de maniere a verifier differents protocoles . . . 

II faut aussi retenir que l'utilisation de tests unitaires, meme si elle a ete exposee 
dans un chapitre dedie aux interfaces graphiques, n'est absolument pas reservee 
aux seuls composants clients. 

OUTIL Eclipse : une plate-forme universelle 

Ce chapitre, en plus de demontrer I'interet de l'utilisation de SWT, vise a ouvrir une perspective 
fort seduisante annoncee par Eclipse : la fin du developpement d'applications graphiques en 
repartant a zero ou presque. En effet, la sortie imminente de la version 2.1 d'Eclipse va rendre 
possible (voire aisee) la possibility d'utiliser Eclipse comme socle universel pour des applications 
completement differentes, c'est-a-dire permettre d'enlever tous les modules non necessaires a 
votre applicatif tout en gardant tous les composants dignes d'interet a vos yeux : aide en ligne, 
impression, composants de haut niveau permettant la selection des fichiers, des couleurs, des 
fontes, etc. Vous n'aurez plus alors qu'a ajouter vos modules pour obtenir une application parfai- 
tement bien adaptee aux contraintes du client en termes de fonctionnalites, et ce en vous con- 
centrant sur votre logique metier et non sur les problematiques recurrentes liees aux impres- 
sions... Tout cela constitue une reelle avancee en matiere de reutilisation logicielle. Avec JFace, 
nous disposons d'une brique de plus haut niveau, nous permettant reellement d'imaginer faire 
d'Eclipse un socle d'applicatifs (un serveur d'applications clientes). En effet, en offrant des servi- 
ces d'aide, d'impression, des editeurs de code et autres outils de haut niveau, Eclipse nous pro- 
met de devenir notre vecteur de distribution d'applications clientes favori. 




Couche de presentation 
des donnees - servlets HTTP 



SOMMAIRE 



Continuons la navigation dans les couches de notre architec- 
ture et abordons la couche de presentation des donnees. 
Celle-ci nous rendra independants par rapport a la couche 
cliente via i'utilisation d'un format de donnees neutre (XML). 
Cette couche va etre accessible par le plus standard des 
protocoles : HTTP. 



► MaTtrise du couplage entre les 
couches 

► Servlets Java et HTTP 

► Presentation du pattern 
Commande et utilisation dans 
un contexte HTTP 

► Serialisation des donnees en 
XML: le projet Castor XML 

► Une alternative SOAP 



MOTS-CLES 

► HTTP 

► Presentation 

► Design pattern Commande 

► Decouplage 

► Introspection Java 

► Serialisation 



Ouverture et maitrise du couplage 



B.A.-BA DTD (Data Type Definition) 

Une DTD est I'expose en XML d'une structure de 
donnees. Un fichier XML peut referencer une DTD ; 
dans ce document, toute donnee non conforme a 
la definition enoncee dans la DTD levera une 
erreur au parsing. 



APARTE Servlet API 

La derniere version stable disponible est la 
version 2.4. 



POUR ALLER PLUS LOIN 
Travailler avec la servlet API 

II est indispensable de posseder « a portee de 
mains » un exemplaire des specifications de la 
servlet API. Vous pourrez les trouver, ainsi que 
d'autres documents tres utiles, sur la page de 
documentation des servlets accessible a I'adresse 
suivante : 

► http://java.sun.com/products/servlet/docs.html. 
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Trop souvent par le passe, BlueWeb, comme de nombreuses autres entreprises, 
s'est trouvee prise au piege, bloquee par le manque d'ouverture des solutions 
logicielles quelle avait pu adopter. Plutot que de faire table rase du passe, elle a 
decide d'en tirer les lecons et, par l'adoption d'une architecture a cinq couches, 
decide de tout mettre en oeuvre pour ne pas lier interface graphique et logique 
metier. Cependant, il faut faire communiquer les deux couches (extremes au 
sens architecture logicielle) et cette communication peut etre la source de 
dependances. 

Pour couper court a tout risque de ce type, l'utilisation d'un format neutre de 
donnees tel que XML permet de s'affranchir de toute dependance, si ce nest 
celle du respect d'un format de donnees sous la forme d'une DTD ou d'un 
schema XML. 

Bien entendu, cette decision a un cout en termes de performances (car cela 
sous-entend transformation des objets en XML et vice-versa), mais le jeu en 
vaut la chandelle s'il y a bien independance par rapport a un langage ou un envi- 
ronnement materiel. Cependant, cette independance n'a de sens que si les com- 
munications entre client et serveur se font, elles aussi via un protocole standard. 
II y a done la une reelle incompatibilite entre ce desir et des solutions fermant de 
nombreuses portes, comme l'invocation d'objets distants en Java via RMI. 

La solution la plus ouverte disponible est sans aucun doute l'utilisation de 
HTTP comme protocole d'echange, puisque ce dernier est disponible sur tous 
les postes clients (il suffit d'inclure les couches TCP/IP dans la configuration du 
poste). 

II reste maintenant a savoir interfacer notre partie serveur avec des requetes 
HTTP. 

Les servlets Java et HTTP 

Ledition professionnelle de la plate-forme Java J2EE comporte parmi ses nom- 
breuses composantes une couche appelee « servlet API », qui permet d'executer 
du code Java a partir de requetes respectant divers protocoles. De par leur con- 
ception, les servlets ne sont pas specifiquement dediees a HTTP (d'ou la classe 
HttpServlet heritant de Servlet), mais en pratique HTTP est pour l'instant le 
protocole implemente (en considerant HTTPS comme une simple surcouche 
d'HTTP). 

Avec la servlet API et un produit l'implementant, nous disposons done d'une 
reponse standard, robuste et simple d'utilisation. 

Rappels sur les servlets 

Cette section rappelle brievement les concepts cles necessaires a l'implementa- 
tion d'une servlet et a son deploiement dans un moteur de servlets. 



Codage 

Le developpement d'une servlet est tout ce qu'il y a de plus simple et repetitif, 
puisqu'il suit le prototype suivant (a adapter pour refleter votre organisation en 
paquetages et a completer pour ajouter vos traitements). 



package com . bl ueweb . server . http . test ; 

import java.io.IOException; 

import java.io. Writer; 

import javax. servlet. ServletConfig; 

i mport j avax . servl et . Servl etExcepti on ; 

import javax . servl et . http . HttpServl et ; 

import javax . servl et . http . HttpServl etRequest ; 

import j avax . servl et . http . HttpServl etResponse ; 

/A* 

* ©author BlueWeb - dev Team 

* <p> 

* Une servlet prototype. 

* </p> 

*/ 

public class PrototypeServlet extends HttpServlet { 

/** 

* <p> 

* La methode init sert a declarer et realiser toutes 

* les initialisations necessaires au fonctionnement 

* d'une servlet (obtention d'une connexion JDBC, ouverture 

* d'un fichier etc. 

* </p> 

* @param aConfig, configuration de la servlet, permet d'obtenir 

* de nombreuses infos 

*/ 

public void init(ServletConfig aConfig) throws Servl etException{ 
super. init(aConfig) ; 

// placer ici toutes les initialisations 
// necessaires a votre servlet 
} // initO 



<P> 

Cette methode est la plus frequemment utilisee ; il s'agit 
de la methode permettant de reagir a une requete HTTP de type 
GET. GET est la methode HTTP « par defaut », c'est-a-dire celle 
realisee lors de la saisie d'une URL dans un navigateur 

</p> 

@param aRequest, correspond a un mapping objet de la requete 
utilisateur 

@param aResponse, permet d'ecrire dans le flux retourne au 
client 



Liste des imports requis pour cette classe. 



La methode i ni t () est appelee au chargement 
de la servlet. On y place le code necessaire aux 
initialisations du type : obtention d'une source 
de donnees, creation de structures. . . 



Cette methode va etre appelee par la methode 
serviceO, non redefinie ici, dans le cas d'une 
requete HTTP de type GET. C'est le type de 
requetes le plus frequemment rencontre. 
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Ici, on va extraire de la requete provenant du 
client un parametre nomme MON_PARAMETRE. 



REFERENCE Descripteur de deploiement 

Pour bien commencer avec le descripteur de 
deploiement, I'URL suivante permet de compren- 
dre les concepts cles de cette etape importante du 
cycle de vie d'une application J2EE : 
► http://jakarta.apache.org/tomcat/tomcat-5.0- 
doc/appdev/deployment.html 



Fichier XML de description du deploiement, qui 
utilise un encodage ISO-8859-1, standard pour 
les pays d'Europe de I'ouest. . . 



Dans cette section, on va trouver un certain 
nombre d'informations tres generales, pas tou- 
jours importantes, telles que la description ou le 
nom devant etre affiche au sein d'outils... 



Ce bloc est d'une importance vitale, il permet 
d'associer a un nom (celui que vous voulez), une 
classe Java contenant le code de votre servlet. 



public void doGet(HttpServletRequest aRequest, 

HttpServletResponse aResponse){ 

// Placer ici tout le code necessaire au traitement. . . 
// suivi du code necessaire a Vecriture de la reponse. 
// Le code suivant n'est donne qu'a titre indicatif. 
// II recupere la valeur associee au parametre 
// MON_ PARAMETRE 

// cela sous-entend une URL du type 
// http://monserveur : sonport/uncontexte/monmappi ng? 
+■ MON_PARAMETRE=unevaleur 

String mon_parametre=aRequest.getParameter("MON_PARAMETRE") ; 

try { 

Writer writer = aResponse.getWriterC) ; 
writer. writeC'une jolie reponse"); 
writer. close() ; 
} catch (IOException e) { 
} 

} // doCetO 

Descripteur de deploiement 

Ce code place dans un moteur de servlets ne fait rien, car on s'est jusqu'a present 
contente de creer une casse pouvant reagir a des requetes HTTP (GET ou 
POST). II s'agit maintenant de preciser au moteur de servlets le contexte neces- 
saire a l'execution de notre code. 

C'est precisement le role du fichier web . xml . Celui-ci nous permet d'associer un 
contexte HTTP a nos servlets, nous autorisant a declarer comment lier une 
servlet a une URL. 

<?xml version="1.0" encoding="ISO-8859-l"?> 



<!D0CTYPE web-app 

PUBLIC "-//Sun Microsystems, Inc. //DTD Web Application 2.3//EN" 
"http : //java . sun . com/j2ee/dtds/web-app_2_3 . dtd"> 

<!--se referer aux specifications pour plus d'informations sur cette 

DTD, cet exemple de fichier omet la section decrivant les filtres HTTP 

--> 

<web-app> 

<! — description generale de 1 'application web — > 

<display-name>BlueWeb - Application Cestion Signets</display-name> 
<description> 

Bla-bla qualifiant 1 'application... N'a qu'un role anecdotique... 
</description> 

<! — 

Parametres d'initialisation du contexte... 
Peuvent etre retrouves par code (depuis une JSP OU SERVLET) 
String value = 
getServletContext() .getInitParameter("name") ; 
Section facultative 
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<context-param> 

<param-name>webmaster</param-name> 
<param-val ue>webmaster@bl ueweb . com</param-val ue> 
<description> 

adresse electronique du webmestre... 
</description> 
</context-param> 

<servlet> 

<servl et-name>controller</servl et-name> 
<descri ption> 

C'est la servlet controleur (cf D.P MVC) . Le chef d'orchestre 
de notre application cote serveur. 
</description> 

<!-- entrer ici une veritable classe, il ne s'agit ici que 
d'un nom fictif — > 

<se rvl et-cl ass>com . mycompany . mypackage . Control 1 erSe rvl et 
</servlet-class> 

<!— montre comment utiliser des parametres dans des servlets --> 
<init-param> 

<param-name>l i stOrders</ param-name> 
<param-val ue>com . mycompany . myacti ons . Li stOrde rsActi on 
</param-value> 
</init-param> 
<init-param> 

<param-name>saveCustomer</param-name> 
<param-val ue>com . mycompany . myacti ons . SaveCustomerActi on 
</param-value> 
</init-param> 

<!-- charge cette servlet au demarrage --> 
<!-- cette valeur >0 veut dire « oui , le conteneur — > 
<!-- doit respecter un ordre croissant dans le — > 
<!-- chargement des servlets » --> 
<load-on-startup>5</load-on-startup> 
</servlet> 

ajouter autant de balises servlets que necessaire --> 
definition des mappings entre URI et servlet a executer — > 
ici, associer la servlet controller a toute URI — > 
se finissant par .do --> 

ce mapping adopte la meme convention que struts... --> 

<servl et-mappi ng> 

<servl et-name>control ler</servl et-name> 

<url -pattern>*.do</url-pattern> 
</servl et-mappi ng> 

<!-- s'il y a d'autres servlets, ajouter ici les clauses --> 

<!-- servl et-mappi ng les concernant --> 

<!-- definition du temps de timeout des sessions HTTP --> 

<session-config> 

<session-timeout>30</session-timeout> <!-- 30 minutes --> 
</session-config> 
</web-app> 

Au sein meme de ce fichier, vous pourrez trouver des commentaires inseres 
selon les regies XML, c'est-a-dire places entre les balises <! — et --> . 



<!- 
<!- 
<!- 
<!- 
<!- 



Ici, on passe des parametres permettant d'initia- 
liser les actions reconnues comme valides (au 
sein de notre petit framework MVC). 
On utilise un systeme tres proche de celui utilise 
au sein de Struts. 



Cette section permet de definir une servlet en 
definissant (au minimum), le nom de celle-ci et 
la classe ]ava contenant I'implementation du 
code a effectuer. 



Cette section permet d'effectuer I'association 
entre une URL et la servlet a executer. 
Par I'expression reguliere *.do, on associera 
toute URL au sein de notre contexte Web finis- 
sant par .do a la servlet dite controller. 
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POUR ALLER PLUS LOIN Reference sur Tomcat 

Ce diagramme est loin d'etre exact, mais il permet 
de comprendre le principe. Pour en savoir plus sur 
le fonctionnement d'un moteur de servlets, on ne 
peut que chaudement recommander I'excellent 
ouvrage de James Goodwill sur Tomcat. 
HI J. Goodwill, Apache Jakarta-Tomcat, APress, 
2001. 



II s'agit ici, en plus d'informations generales (nom de l'application web), de 
lister toutes les servlets (en associant a un nom, un nom de classe Dava), puis 
d'associer a une forme d'URL un nom de servlet. 

Le diagramme UML suivant synthetise les grandes lignes du mecanisme 
d'invocation d'une servlet. 




«comment» 
lisDeploymentDescriptor 
permet decherchers'il 
existe un mapping entre une 
servlet etl'URL demandee. 



«comment» 
Selon la methode 
d'invocation HTTP, 
doGet ou doPost 
sera appeleesurla 
servlet. 



Figure 4-1 Diagramme de sequences UML schematisant le dialogue client/serveur 



Packaging 

Sans le savoir et tel Monsieur Jourdain, vous etes en train de realiser une 
WebApp (application web). Pour la distribuer, et done l'utiliser, vous devez vous 
plier aux contraintes fixant le packaging. II ne peut s'agir ici de rappeler ces con- 
traintes, mais nous mettrons tout cela en pratique par la suite. Suivant le moteur 
de servlets utilise, vous pourrez ou non disposer de certains outils facilitant le 
deploiement. Rappelons simplement que vous aurez le choix entre differentes 
politiques : 

• ajouter une hierarchie de fichiers a un endroit donne de votre moteur de 
servlets ; 

• deployer un war f i 1 e (archive au format . jar contenant une WebApp) ; 
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• deployer un ear f i 1 e (archive au format . j ar contenant une entreprise appli- 
cation). 

A ce stade, vous devez etre capables d'aborder le developpement de servlets et 
leur deploiement. 

Maintenant examinons comment mettre en place « proprement » cette techno- 
logic, de maniere a l'inserer dans notre architecture. 



Le pattern Commande et les requetes HTTP 

A la maniere des frameworks MVC ou MVC2 du type Struts ou Barracuda, 
l'equipe de BlueWeb decide pour le projet prototype d'opter pour une imple- 
mentation « maison » de ce design pattern. 

Pourquoi reecrire une implementation de ce design pattern et ne pas utiliser un 
des frameworks existant ? Plusieurs raisons ont contribue a opter pour cette 
voie : 

• Ecrire une implementation de ce pattern pour un projet pilote permet de 
bien l'apprehender et done de bien le maitriser. 

• Le temps imparti au projet n'etant pas infini, il est plus realiste d'implemen- 
ter quelque chose de fonctionnellement limite plutot que de se perdre dans 
les meandres d'un projet ambitieux. 

• Cette experience permettra dans l'avenir d'acquerir des connaissances per- 
mettant d'etre plus critique (au sens positif du terme) au sujet de produits 
MVC comme Struts. Ce framework seduisant attire de nombreuses person- 
nes chez BlueWeb et il n'est pas exclu de lancer prochainement un projet 
pilote utilisant ce produit. 

Schema general du design de cette implementation 



MVC et MVC2 



Dans le Modele Vue Controleur 2, il n'y a plus 
qu'un seul controleur au lieu de plusieurs. Ceci 
permet d'eviter une proliferation genante 
d'endroits ou trouver la logique metier. 



http://unserveur.undomain.extension:port/mainServlet?commande=unecommande 



Client 



flux XML 



Servlet Dispatcher 



Une commande 



Figure 4-2 Schema de principe du pattern MVC applique au Web 



L'idee est simple mais efficace : associer une action utilisateur (ajouter un signet) 
a une commande (cote serveur) et acheminer toutes les actions via HTTP vers 
la servlet principale assurant un role de repartition et de gestion des erreurs 
(ainsi qu'un role de conversion Java <-> XML). 

Avant de regarder l'implementation, examinons un peu le design pattern Com- 
mande... 



ANTI-PATTERN La servlet magique 

Dans son ouvrage « Bitter Java » Bruce Tate 
decrit tres bien ces servlets « magiques », con- 
cues pour ne faire qu'une seule chose mais dont 
le code grossit au fur et a mesure des evolutions 
jusqu'a en devenir impossible a maintenir (les 
besoins peuvent avoir change, les cas de figure 
peuvent s'etre multiplies et le code avoir 
enfle...). Les problemes de bogues d'execution 
n'apparaissent que quand le code franchit le cap 
fatidique des 64 Ko pour une methode. Ce 
design permet de mieux nous affranchir des pro- 
blemes que Ton ne peut apprecier a I'avance : 
en effet, comment prevoir la facon dont va evo- 
luer I'application ? 



POUR ALLER PLUS LOIN Filtres HTTP 

La servlet API 2.3 a introduit une notion de filtrage 
des requetes HTTP. Cette nouveaute par rapport a 
la version precedente (la 2.2) nous permet d'ecrire 
un code portable d'un moteur de servlets a I'autre 
et fournissant les memes fonctionnalites que des 
API proprietaires telles que les Valve de Tomcat. 
Avec I'interface javax. servlet. Filter, nous 
disposons d'un moyen simple et puissant de reali- 
ser differentes taches repetitives, sans pour cela 
polluer le code de nos servlets. Un filtre HTTP est 
done une classe lava, qui sera executee avant 
reception de la requete HTTP par notre servlet et 
apres I'envoi de la reponse. L'interet devient evi- 
dent quand il s'agit de realiser des taches telles 
que filtrage, logging ou verification de droits utili- 
sateur (authentification). Bien sur, cela sous- 
entend un moyen de realiser I'association entre les 
filtres et les URL. Ceci est standardise et ce map- 
ping est fait au niveau du fichier de deploiement : 
web.xml. La version presentee precedemment ne 
tenait pas compte de cette notion par souci de 
simplicite. 



Le pattern Commande (Command) en quelques mots 

Utilisable cote client comme cote serveur, ce pattern permet d'ecarter le pro- 
bleme frequemment rencontre des servlets « magiques ». 

L'objectif est done de modeliser (encapsuler) une action (lister tous les signets, 
effacer un signet...) sous forme d'une classe, et ce de maniere a ce que Ton 
puisse maintenir I'application simplement en ajoutant de nouvelles commandes 
pour les nouvelles actions, en modifiant le code d'une commande precise si 
Taction attachee semble erronee. 

Ceci peut etre traduit par le petit diagramme de sequences UML de la 
figure 4-4. 



/Command 

execute!) 
I 

Co ni ma n d eCon crete 



executed 

Figure 4-3 Diagramme de classe d'une commande 



client: 




1 nstance: C ommandeC oncrete 






1 

execute ^ | 








u 






< 


1 








1 

I 



Figure 4-4 Diagramme de sequence de principe 



Le design pattern Commande est un des plus celebres, car il est utilise dans de 
nombreux contextes. Ainsi, dans le monde Java/Swing, il est utilise classique- 
ment pour gerer l'Undo/Redo. La classe AbstractAction Swing est tres proche de 
I'interface Command definie dans le diagramme de classes precedent. 

Quels sont les benefices de cette conception ? En groupant (isolant) le code 
d'une action dans une seule classe, on obtient de nombreuses petites classes de 
taille reduite, done simples a maintenir et a faire evoluer, car moins sujettes aux 
effets de bord. Par ailleurs, cette conception a le merite de permettre une paral- 
lelisation des developpements, car deux codeurs peuvent travailler en meme 
temps sur deux actions utilisateur differentes. 
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Un design pattern en pratique : les Interceptors JBoss 

On peut noter un usage tres interessant de ce pattern dans l'architecture du 
projet JBoss, avec la notion dans ce projet d'Interceptor. JBoss 3 avec ce design 
est un produit extremement flexible et configurable selon vos besoins en ajustant 
quelques fichiers de configuration. Mais avant d'en arriver la, examinons cette 
notion, fondamentale dans ce produit. 

Un Interceptor a pour vocation d'encapsuler une action (service technique tel 
que transaction, authentification, persistance geree par le conteneur...) au sein 
d'une invocation d'un EJB par un client. II s'agit dune simple classe Java qui 
sera invoquee par le conteneur, lors d'un appel a un service d'un EJB. JBoss est 
concu pour permettre l'appel de un a plusieurs de ces objets, lors de toute invo- 
cation. Ainsi done et sans le savoir, avant et apres traitement, notre appel est 
passe a travers une serie d'objets. Cette notion est tres proche de la notion de fil- 
tres HTTP introduite dans l'encadre. 

La figure 4-5 presente le diagramme general d'un appel a un service d'un EJB 
au sein de JBoss. 



B.A.-BA Intercepteur 



Ce terme provient du monde Corba ou il designe 
un composant dont la fonctionnalite est tres pro- 
che des intercepteurs dans JBoss. Ces composants 
permettent de realiser un certain nombre de 
taches de maniere transparente pour le codeur, 
comme I'ajout de traces, I'authentification... 
Taches que Ton retrouve dans le fichier de descrip- 
tion des intercepteurs dans JBoss. La finalite est 
d'alleger le code, de diminuer le nombre de para- 
metres dans les methodes (et done d'ameliorer la 
lisibilite et faciliter la maintenance), et aussi 
d'automatiser I'execution de taches repetitives en 
les executant a un niveau tres bas dans le proto- 
cole en interceptant les appels de methodes. 



Etape 1 



Etape 2 



r 



Client 



Interceptor 1 



Interceptor 2 



5£ 

2 



Interceptor n 



Etape n+1 



Traitement de la requete 



EJB 



J 



La reponse est soumise 
aux memes filtres 



Renvoi de la reponse 



Figure 4-5 La pile des intercepteurs dans JBoss 



Les fichiers de configuration de JBoss 3 vous permettent de modifier l'ordre, le 
nombre et le type des intercepteurs devant etre utilises pour toutes les applica- 
tions (dans le fichier standardjboss.xml) ou pour une seule application (par le 
fichier jboss.xml). Les balises Interceptor sont inserees au sein des balises 
Container-configuration. 
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Dans cette section, on va trouver la liste des ► 
intercepteurs associes aux entites. On voit que 
ceux-ci sont en rapport avec differents domaines 
tels que la persistance, la securite ou les transac- 
tions... 



Void un extrait du fichier standard j boss .xml livre dans JBoss 3.20RC4 (der- 
niere version disponible a ce jour). 



Fichier de configuration de la pile des intercepteurs dans JBoss 




<contai ner-conf i gu rati ons> 

<contai ner-conf i gu ration> 
<container-name>Standard CMP 2.x EntityBean</container-name> 
<cal 1 -1 oggi ng>f al se</cal 1 -1 oggi ng> 
<sync-on-commit-only>fal se</sync-on-commit-only> 

<contai ner-i nterceptors> 
<i nterceptor>org . jboss . ejb. pi ugi ns . Proxy Factory Fi nderlnterceptor 
</interceptor> 

<i nterceptor>org .jboss . ejb . pi ugi ns . LogInterceptor</i nterceptor> 
<i nterceptor>org .jboss . ejb . pi ugi ns . Securi tylnterceptor 
</interceptor> 

<i nterceptor>org .jboss . ejb . pi ugi ns .TxInterceptorCMT 
</interceptor> 

<i nterceptor metri csEnabl ed="t rue"> 

org . jboss . ejb . pi ugi ns . Metri csInterceptor</i nterceptor> 
<i nterceptor>org . j boss . ej b . pi ugi ns . Enti tyCreati onlnterceptor 
</interceptor> 

<i nterceptor>org . jboss .ejb . pi ugi ns . Enti tyLocklnterceptor 
</interceptor> 

<i nterceptor>org .jboss . ejb . pi ugi ns . Enti tylnstancelnterceptor 
</interceptor> 

<i nterceptor>org . j boss . ej b . pi ugi ns . Enti tyReentrancelnterceptor 

</interceptor> 

<interceptor> 

org .jboss . resource . connecti onmanager . CachedConnecti onlnterceptor 
</interceptor> 
<interceptor> 

org . j boss . ejb . pi ugi ns . Enti tySynch roni zati onlnterceptor 
</interceptor> 
<i nterceptor> 

org . j boss . e jb . pi ugi ns . cmp . jdbc . DDBCRel ati onlnterceptor 
</interceptor> 
</contai ner-i nterceptors> 

<i nstance-pool >org . jboss . ej b . pi ugi ns . Enti tylnstancePool 

</instance-pool> 

<instance-cache> 

org . j boss . ejb . pi ugi ns . Inval i dabl eEnti tylnstanceCache 
</i nstance-cache> 
<persi stence-manager> 

org . j boss . ejb . pi ugi ns . cmp .jdbc . DDBCStoreManager 
</persistence-manager> 

<transaction-manager>org. jboss. tm.TxManager</transaction-manager> 

Cet extrait montre la configuration standard d'un composant entite en mode 
CMP 2.0. II est impressionnant de constater que tout appel a ce composant 
induira une invocation en cascade de treize intercepteurs ! 
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Maintenant que le principe est acquis, examinons la structure globale d'un 
Interceptor dans JBoss. Tout d'abord, voici l'interface definissant les services 
basiques offerts par tout intercepteur. 

" /* 

* JBoss, the OpenSource J2EE webOS 

* Distributable under LCPL license. See terms of license at gnu.org. 

*/ 

package org. jboss.ejb; 

import org . j boss . i nvocati on . Invocation ; 

/** 

* Provides the interface for all container interceptors. 

* ©author <a href="mailto: rickard.oberg@telkel .com">Rickard Oberg</a> 

* ©author <a href="mailto:marc.fleury@jboss.org">Marc Fleury</a> 

* ©version SRevision: 1.10 $ 
*<p>20011219 marc fleury:</p> 
*/ 

public interface Interceptor 

extends ContainerPlugin 

{ 

* Set the next interceptor in the chain. 

* @param interceptor The next interceptor in the chain. 

*/ 

void setNext(Interceptor interceptor); 

* Get the next interceptor in the chain. 

* ©return The next interceptor in the chain. 

*/ 

Interceptor getNext(); 

Object invokeHome(Invocation mi) throws Exception; 
Object invoke(Invocation mi) throws Exception; 



Cette interface est plutot reduite (4 methodes 
seulement). Les methodes fondamentales sont 
celles en rapport avec I'invocation d'objet 
(invoke et invokeHome). C'est d'ailleurs 
celles-ci que nous redefinirons. . . 



} 



Voici ensuite un extrait du code source d'une des implementations de cette 
interface, un objet assurant l'ecriture de traces. 



/* 

* JBoss, 

* Distri 

*/ 

package 

import j 

import j 

import j 

import j 

import j 

import j 

import j 

import j 

import j 



the OpenSource J2EE webOS 
butable under LCPL license. See terms of license at gnu.org. 

org. j boss. ejb.pl ugins; 

ava.io.PrintWriter; 

ava . i o . St ri ngWri te r ; 

ava . rmi . NoSuchOb j ect Excepti on ; 

ava . rmi . RemoteExcepti on ; 

ava. rmi .ServerError; 

ava. rmi .ServerException; 

ava.util .Map; 

avax.ejb. EJBException ; 

avax . e jb . NoSuchEnti tyExcepti on ; 



Imports necessaires a I'execution et a la compi- 
lation de la classe. 
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Cet intercepteur assure un role lie aux traces. 
Suivant I'etat d'un booleen, il tracera revoca- 
tion de la methode (en ajoutant un message 
start method avant le debut de la methode 
appelee et un message Stop method apres la 
fin de celle-ci. 



Le nom du bean est renseigne dans les meta- 
donnees (fichier de configuration XML, lu et 
charge en memoire). 



Stocke le nom de I'EJB dans le thread contexte, 
manipule ici comme une pile. 



Exemple d'un intercepteur de JBoss tire du code source 

i mport javax . e jb . NoSuchObjectLocal Except! on ; 

i mport javax . ejb .Transact! onRol 1 edbackLocal Excepti on ; 

i mport javax .transact! on .Transact! onRol 1 edbackExcepti on ; 

import org. apache. log4j .NDC; 

import org. jboss.ejb. Container; 

i mport org . j boss . i nvocati on . Invocati on ; 

i mport org . j boss . i nvocati on . Invocati onType ; 

i mport org . j boss . metadata . BeanMetaData ; 

i mport org . j boss . tm . IBossTransacti onRol 1 edbackExcepti on ; 

i mport org . j boss . tm . HBossTransacti onRol 1 edbackLocal Excepti on ; 

/** 

An interceptor used to log all invocations. It also handles any 
unexpected exceptions. 

©author <a href="mailto: rickard.oberg@telkel .com">Rickard Oberg</a> 

* ©author <a href="mailto:Scott.Stark@jboss.org">Scott Stark</a> 

* ©author <a href="mailto:dain©daingroup.com">Dain Sundstrom</a> 

* ©author <a href="mailto:osh@sparre.dk">01e Husgaard</a> 

* ©version SRevision: 1.24.2.6 $ 
*/ 

public class Loglnterceptor extends Abstractlnterceptor 

{ 

// Static 

// Attributes 

protected String ejbName; 

protected boolean call Logging; 

// Constructors 

// Public 

// Container implementation 
public void create () 
throws Exception 

{ 

super. start() ; 

BeanMetaData md = getContainer() .getBeanMetaData() ; 

ejbName = md.getEjbName() ; 
// Should we log call details 

callLogging = md.getContainerConfigurationO .getCallLoggingO ; 

} 

* This method logs the method, calls the next invoker, and handles 

* any exception. 

* 

* ©param invocation contain all infomation necessary to carry out 

* the invocation 

* ©return the return value of the invocation 

* ©exception Exception if an exception during the invocation 

V 

public Object invokeHome (Invocati on invocation) 
throws Exception 



{ 



NDC.push(ejbName) ; 
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Exemple d'un intercepteur de . 

String methodName; 

if (invocation. getMethod() != null) 

{ 

methodName = invocation. getMethod() .getName() I 

} 

else 
{ 

methodName = "<no method>"; 

} 

boolean trace = log.isTraceEnabled() ; 

if (trace) 

{ 

log.trace("Start method=" + methodName); 

} 

// Log call details 
if (call Logging) 
{ 

StringBuffer str = new StringBuffer("InvokeHome: ") ; 
str.append(methodName) ; 
str.append("(") ; 

Object [] args = invocation.getArguments() ; 

if (args != null) 

{ 

for (int i =0; i < args. length; i++) 
{ 

if (i > 0) 
{ 

str.append(",") ; 

} 

str.append(args[i]) ; 

} 

} 

str.append(")") ; 
log.debug(str.toStringO) ; 

} 

try 
{ 

return getNext() . invokeHome(invocation) ; 

} 

catch (Throwable e) 
{ 

throw handleException(e, invocation); 

} 

finally 
{ 

if (trace) 
{ 

log.trace("End method=" + methodName); 

} 

NDC.popO; 
NDC. remove (); 

} 



< Est-ce que le mode de trace est active ? 



On batit la sortie (trace) en ajoutant le nom de la 
methode et les arguments... On remarque I'utili- 
sation judicieuse d'un StringBuffer en lieu et 
place de I'operateur et de la classe String. Et 
ce, pour des raisons de performance. 
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On recupere le nom de la methode invoquee s'il ► 
ya lieu (non nul). 




* This method logs the method, calls the next invoker, and handles 

* any exception. 



* 

* @param invocation contain all infomation necessary to carry out 

* the invocation 

* ©return the return value of the invocation 

* ©exception Exception if an exception during the invocation 

V 

public Object invoke (Invocation invocation) 
throws Exception 

{ 

NDC.push(ejbName) ; 
String methodName; 

if (invocation. getMethod() != null) 
{ 

methodName = invocation .getMethod() .getNameO ; 

} 

else 
{ 

methodName = "<no method>"; 

} 

boolean trace = log.isTraceEnabled() I 

if (trace) 

{ 

log.trace("Start method=" + methodName); 

} 

// Log call details 
if (call Logging) 
{ 

StringBuffer str = new StringBuffer("Invoke: "); 
if (invocation.getldO != null) 

{ 

str.append(" [" + invocation.getldO .toStringO + "] "); 

} 

str. append (methodName) ; 
str.append("(")l 

Object[] args = invocation. getArguments() ; 

if (args != null) 

{ 

for (int i = 0; i < args. length; i++) 
{ 

if (i > 0) 
{ 

str.append(","); 

} 

str.append(args[i]) ; 

} 

} 

str.append(")") ; 
log.debug(str.toStringO) ; 

} 
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Exemple d'un ir 



return getNext() .invoke (invocation) ; 



try 
{ 

} 

catch (Throwable e) 
{ 

throw handleException(e, invocation); 

} 

finally 
{ 

if (trace) 
{ 

log.trace("End method=" + methodName) ; 

} 



} 



NDC.popO; 
NDC. remove () ; 



} 



Ce qu'il faut retenir de ce code est que le schema d'un Interceptor est globale- 
ment toujours le meme, puisqu'il s'agit de proceder suivant quatre etapes : 

1 traitement d'entree ; 

2 appel de l'intercepteur suivant ; 

3 traitement de sortie ; 

4 sortie retournant la valeur renvoyee par la file d'appels. 

Cette longue parenthese doit vous permettre d'apprehender l'importance pra- 
tique d'un tel motif de conception et comment, lorsqu'il est utilise avec justesse, 
celui-ci permet d'isoler de maniere elegante des traitements annexes a votre 
application. II est tres interessant de preciser, ici, que dans le cas de JBoss, la 
logique est poussee a son paroxysme, puisque tout le travail est realise par ces 
intercepteurs et que le code du serveur EJB central est quasiment celui d'un ser- 
veur JMX (Java Management Extensions), c'est-a-dire un serveur d'administra- 
tion d'applications locales ou distantes. 



Implementation dans le projet BlueWeb 

Nous n'allons pas detailler tout le code utilise pour cette couche, mais simple- 
ment nous attarder sur quelques passages. 

Le point cle de notre implementation reside dans l'interface IHttpCommand pre- 
sentee ci-apres. 

package com . bl ueweb . bookmarks . http ; 
import java.util .Map; 



Code source complet 



Pour obtenir un listing complet du code du projet, 
se reporter au site web compagnon de I'ouvrage. 
► www.editions-eyrolles.com 
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Interface minimaliste mais suffisante pour notre 
propos. C'est la plus fidele representation du 
design pattern Commande. 



* ©author BlueWeb - 2003 

* <p> 

* Cette interface definit les fonctionnalites d'une commande 

* HTTP au sens de notre architecture (Pattern Command). 

* Le seul service requis est en fait 1 'implementation de la 

* methode execute (). 

* Une commande sera lancee depuis la servlet controleur, 

* puis le resultat post-traite de retour dans la servlet controleur. 

* </p> 

*/ 

► public interface IHttpCommand { 

/** 

* <p> 

* execute une requete cliente transmise par la servlet controleur. 

* Celle-ci se doit d'alimenter correctement la map d'entree 

* et doit se charger de serialiser (s'il y a lieu) les objets 

* transmis en sortie (dans outputMap) 

* </P> 

* @param inputMap, tableau associatif contenant les objets 

* necessaires a 1 'execution de la commande 

* @param outputMap, tableau associatif contenant les objets 

* retournes au client 

* ©exception CommandAbortedException , si 1 'execution echoue 

V 

public void handleRequest(Map inputMap, Map outputMap) 
throws CommandAbortedException; 



Cette interface utilise une exception dont le code (tres simple) est : 

package com . bl ueweb . bookmarks . http ; 

/** 

* ©author BlueWeb 

* <p> 

* Une exception levee des l'echec de 1 'execution d'une commande 

* </p> 

V 

public class CommandAbortedException extends Exception { 

/** 

* Constructor for CommandAbortedException. 

* @param aMessage 

public CommandAbortedException(String aMessage) { 
super(aMessage) ; 

} 

} 

On peut remarquer aussi un passage de la servlet controleur (classe Mai nServl et) 
permettant d'initialiser au chargement de la servlet (c'est-a-dire au chargement 
de la webapp d'apres les directives du web.xml) la liste des commandes valides et 
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les classes d'implementation les realisant (sous la forme d'un objet 
java.util .Properties). 

public void init(ServletConfig aConfig) throws ServletException{ 
//invocation de la methode parente indispensable 
super. init(aConfig) ; 
//obtient le contexte d' execution 
servletContext = aConfig.getServletContextO I 
try{ 

String mapping_file = aConfig.getInitParameter( "commands.file" ); 
//obtient le fichier de commandes via 
//les parametres d'initialisation de la servlet 

servletContext. log("mapping file = " + mapping_file );// log 

commandsMap = new Properties() ;// initialise la map 

try{ 

// charge le fichier 

commandsMap . 1 oad (servl etContext . getResourceAsStream(mappi ng_f i 1 e)) ; 
logger. debug("fetched a number of commands = " + commandsMap. size()) ;// log 

} 

catch (Exception e){ 

logger. info("unable to access the properties file"); 

} 

Presentation des donnees 

Le decouplage souhaite entre partie cliente et logique serveur necessite l'utilisa- 
tion d'un format neutre de donnees, si Ton desire portabilite et independance du 
langage (remplacer la partie cliente par une interface C++ par exemple). 

XML est ce format neutre. Nos servlets sont accessibles par HTTP ; maintenant, 
nous allons faire en sorte qu'elles soient capables d'interpreter des requetes com- 
portant des parametres XML et bien entendu de renvoyer du XML en sortie. 

On voit apparaitre clairement deux phases au cours desquelles il y a transforma- 
tion sous forme d'objets des parametres transmis (« deserialisation ») et trans- 
formation en XML d'objets Java (« serialisation »). Notre architecture est done 
dans l'esprit comparable aux architectures d'objets distribues type Corba 
(Common Object Request Broker Architecture). 

Maintenant se pose la question : comment serialiser des objets Java en XML ? 

Serialisation d'objets Java 

C'est un sujet brulant puisqu'il est a la base de bien des preoccupations de 
l'industrie. En effet, la serialisation d'objets est utilisee intensivement dans les 
serveurs d'applications (EJB), les Services web (SOAP), etc. 

L'equipe BlueWeb a opte pour une bibliotheque nommee Castor, permettant de 
creer un pont entre le monde objet et XML, et ce a un faible cout en termes de 
performances. Cette bibliotheque manipulee dans la servlet et dans la couche 
cliente se doit en effet d'etre econome en ressources (memoire et CPU). 



APARTE Serialisation 

Dans le monde Corba, cette etape s'appelle le 
marshalling, le pendant de la deserialisation etant 
appele unmarshalling. Ces mots sont repris dans 
d'autres vocables comme dans celui de SOAP. 
C'est le nom d'une technologie qui facilite la publi- 
cation d'objets sur le Web : les Web Services. Cette 
etape permet de transformer un objet en flux ; elle 
a bien sur son pendant (la deserialisation), qui 
transforme un flux (fichier texte) en un objet (Java 
ou C++). 



OUTIL Castor 

Castor est un produit sous licence BSD qui s'avere 
agreable, stable, bien maintenu et rapide. Si Ton 
ajoute une documentation de qualite, alors pour- 
quoi s'en priver ? 
► http://castor.exolab.org 
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Cet exemple montre comment charger dynami- 
quement une classe par le biais de la classe 
Class et de la methode forName().Puis com- 
ment invoquer une methode en connaissant son 
nom et sa signature exacte (arguments). II faut 
toutefois bien specifier aux programmeurs debu- 
tants que cette methode extremement puissante 
n'a de sens que dans certains contextes et 
qu'elle n'a quasiment plus hen d'objet 
puisqu'elle permet d'outrepasser les principes de 
visibility de methodes ou d'attributs. 



Castor propose deux types de serialisation/deserialisation : 

• une premiere, totalement dynamique, basee sur l'introspection Java ; 

• une seconde methode utilisant un fichier de mapping XML guidant la con- 
version. 



B.A.-BA Introspection 

L'introspection est un des atouts de Java qui permet dynamiquement de decouvrir puis d'utiliser 
des objets. Les principals classes intervenant dans ce mecanisme sont : java. Tang. Class, 
java.lang.ClassLoader et le paquetage java. Tang, reflect. Vous trouverez ci-apres 
un exemple de code mettant en jeu ces mecanismes. Attention, l'introspection est un outil qui 
fait tres bien son travail, mais qui doit etre limite a une utilisation ponctuelle pour des morceaux 
de code necessitant ce degre de liberte, car cette technique permet d'outrepasser toutes les 
regies objets de visibility etc. 



La premiere methode a l'avantage d'etre tres simple a mettre en oeuvre 
(puisqu'elle ne necessite rien d'autre que le bytecode de la classe a traiter). 

package com. blueweb. test. castor; 
import java.lang. reflect. Method; 

/** 

* ©author J.MOLIERE - 2003/01 

* <p> 

* Une classe mettant en oeuvre l'introspection en ]ava. 

* Donnee a titre informatif, elle ne fait rien de 

* spectaculai re et ne montre pas toutes les possibilites de ce 

* paquetage 

* </p> 

*/ 

► public class Testlntrospection { 
static class Base{ 
public void foo(){ 

System. err. println("Base: :foo") ; 

} 

} 

static class Heritiere extends Base{ 
public void foo(){ 

System. err.println("Heri tee :foo") ; 

} 

} 

/** 

* <p> 

* methode main. 

* ne s'occupe pas des exceptions.. 

* </p> 

V 



90 



public static void main(String[] args) throws Exception{ 
Class dyn class = Heritiere. class; 

// on demande a cette instance de nous donner sa classe mere 
Class super class = dyn class. getSupercl ass () ; 

// affiche dans la console la super-classe de la classe 
// heritiere 

System. err. println("Super classe = " + superclass. getNameO) ; 
// instancie la classe heritiere puis appelle la methode foo() 
// c'est une invocation classique regie par le compilateur 
Heritiere obj_instance = (Heritiere)dyn_class.newlnstance() ; 
obj_instance.foo() ; 
// invoque foo() dynamiquement 

// la methode foo n'a pas de parametres d'ou le null 
// voi r javadoc. . . 

// attention ici aucun garde-fou 

// le compilateur ne peut vous proteger 

Method method foo = dyn cl ass. getDeclaredMethod("foo", null) ; 
method foo. invoke ( dyn class. newInstanceQ ,null) ; 



} 

Utilisation typique de Castor/XML 

La figure 4-6 permet de visualiser les grandes etapes d'un processus de deseriali- 
sation (transformation XML vers Java). Elle se base sur l'utilisation d'un fichier 
de mapping (deuxieme methode). 



On va utiliser la meta-classe Class pour : 

- instancier dynamiquement un objet ; 

- appeler un service sur cet objet ; 

- recuperer et afficher sa super-classe. 



S 



client proq: 



CreateAction 



lnstance:Unmarshaller 



setM apping 



J] 



«comment» 


K 


cree 1 e 




unmarshaller 






«comment» 


K 


initialise 1 'objet 




avec un fichier de 




mapping 





unmarshal 



«description» L\ 
Utilisation typique 
deCastor/X.M 1 



«comment» L\ 
deserialise I 'objet 
lu dans un Reader 
ou autre source. 



Figure 4-6 

Utilisation typique de Castor XML 



91 



Soit un code du type : 



Import des classes utilisees. 



REMARQUE Adaptation du code 

II est laisse a la charge du lecteur le soin de 
modifier le chemin (c:\temp\castor- 
out.xml) afin de I'adapter a son systeme, ainsi 
que la tache de modifier son environnement 
pourfaire tourner I'exemple... 



On instancie un objet nous servant de reference 
pour nos tests ulterieurs. Cet objet est une ins- 
tance de la classe DummyClass, qui est reduite 
a quelques champs et aux accesseurs associes 
(nom et age) . 



Le resultat de la serialisation de cet objet par 
Castor sera stocke dans un fichier, ici sous 
Windows avec un chemin c:\temp\castor- 
out.xml. Bien entendu, les « Unixiens » 
devront adapter ce chemin et les amateurs de 
Windows devront veiller a creer un repertoire 
temp sous la racine du lecteur C. 



Utilisation basique de Castor XML 

package com. blueweb. test. castor; 

import java.io. FileReader; 
import java.io. FileWriter; 
import java.io.IOException; 
import java.io. Reader; 
import java.io. Writer; 

import org. exolab. castor. xml .Marshal Exception; 
import org. exolab. castor. xml . Marshal ler; 
import org. exolab. castor. xml .Unmarshaller; 
import org. exolab. castor. xml .Val idat ion Except ion; 

/** 

* ©author BlueWeb - 2003 
<p> 

Une classe testant Castor. 

Ce test reste tres simple intentionnellement. 

Utilise la premiere forme de serialisation/deserialisation possible: 

* celle basee sur 1 'introspection ]ava (done pas de fichier de 

* mapping). On notera le fait que Castor depende de xerces (xml API. jar 

* et xerceslmpl .jar) 

On peut aussi noter que l'on peut utiliser les methodes statiques 
des classes Marshaller et Unmarshaller plutot que de les instancier... 
</p> 

/ 

public class MarshalUnmarshalClass { 

/** 

* <p> 

* ignore les exceptions, dans ce contexte d'un petit 

* bout de code de test. 

* </P> 

V 

public static void main(String[] args) throws IOException, 
IOException, Marshal Exception, Marshal Exception, ValidationException { 

// cree Toto, qui vient d' avoir 18 ans... 

DummyClass test_object = new DummyClass() ; 

test_object.setAge(18) ; 

test_object.setName("toto") ; 

// pour feter cela, on va sauvegarder ces informations 

// dans un fichier XML (c\temp\castor-out.xml) 

Writer writer = new FileWriter("c:\\temp\\castor-out.xml ") ; 

Marshaller marshaller = new Marshaller(writer) ; 

marshal ler. marshal (test object) ; 

writer. close() ; 
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// on va quand meme s'assurer que l'objet a ete bien sauvegarde 
Reader reader = new FileReader("c:\\temp\\castor-out.xml") ; 
// on peut remarquer ici le raccourci d'ecriture 
// DummyClass. class 

Unmarshaller unmarshaller = new Unmarsha~ller(DummyCl ass. class) ; 

DummyClass read_object = (DummyClass)unmarshaner.unmarshal (reader) ; 
System. err. println("Objet lu a un nom = " + 

read_object.getName() + " et un age =" + 

read_object.getAge()) ; 



Rien de tel qu'une verification du resultat... 
Pour cela, on va lire le fichier cree precedem- 
ment et utiliser un Unmarshaller pour creer 
une instance de notre classe originale 
(DummyClass). On verifiera la coherence des 
informations stockees dans le fichier et celles de 
I'objet de test en examinant la console. . . 



La classe DummyClass est une simple classe serialisable (done transportable sur 
un reseau ou sur un systeme de fichiers) dont le code est fourni ci-apres : 

package com. blueweb. test. castor; 
import java.io.Serializable; 

public class DummyClass implements Serial izable { 



public DummyClassO { 
super(); 

} 

private String name; 

private int age; 
public int getAge() { 
return age; 

} 

public String getName() { 
return name; 

} 

public void setAge(int age) { 
this. age = age; 

} 

public void setName(String name) { 
this. name = name; 

} 



Une petite classe de test contenant quelques 
champs : elle est serialisable (voir 
java.io.Serializable). 



Constructeur de DummyCl ass. 



< Renvoie I'age (int). 



< Renvoie le nom (stri ng). 



Instancie I'age : le parametre age contient I'age 
a instancier. 



Instancie le nom : le parametre name contient le 
nom a instancier. 
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Utilise un fichier de mapping pour guider la ► 
transformation Castor. Ici il est imperatif de 
manipuler les methodes d'instance et non les 
simples methodes statiques. 



Toto a toujours 18 ans. 



On sauvegarde.. 



Ici on charge un fichier de mapping. 



Puis on serialise. 



On teste si cela a fonctionne. 



Maintenant, regardons comment utiliser l'autre forme de transformation proposee 
par Castor. Ici, il va s'agir d'utiliser un fichier de mapping guidant la transforma- 
tion plutot que d'utiliser la decouverte dynamique des attributs proposee par Java. 

package com. blueweb. test. castor; 

import java.io.FileReader; 

import java.io.FileWriter; 

import java.io. Reader; 

import java. io. Writer; 

i mport org . exol ab . castor . mappi ng . Mappi ng ; 

import org. exolab. castor. xml .Marshaller; 

import org. exolab. castor. xml .Unmarshaller; 

/** 

* ©author BlueWeb 

V 

public class UtilisationMapping { 

private final static String 0UT_FILE= "c:\\temp\\out-castor-2.xml"; 
private final static String MAPPING^FILE ="c:\\temp\\mapping.xml"; 
public static void main(String[] args) throws Exception { 

DummyClass toto = new DummyClassO ; 
toto.setName("toto") ; 
toto.setAge( 18) ; 

Writer writer = new FileWriter(OUT_FILE) ; 
Marshaller marshaller = new Marshaller(writer) ; 

Mapping mapping file = new Mappi ng(); 
mappi ng f i 1 e . 1 oadMappi ng (MAPPING FILE) ; 
marshal 1 er . setMappi ng (mappi ng f i 1 e) ; 

marshal 1 er . marshal (toto) ; 

Reader reader = new FileReader(OUT_FILE) ; 

Unmarshaller unmarshaller = new Unmarshaller(DummyCl ass. class) ; 
unmarshal 1 er . setMappi ng (mappi ng f i 1 e) ; 

try{ 

Object obj from stream = unmarshall er. unmarshal (reader) ; 
System. err. println("Classe de l'objet lu = " + 

obj_f rom_stream.getClass() .getNameO) ; 
DummyClass read_object =(DummyClass)obj_f rom_stream; 
System. err. println("Nom de l'objet lu = " + 

read_object.getName()+ " Age = " + read_object.getAge() ); 

} 

catch(Exception e){ 
e.printStackTraceO; 

} 
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On peut utiliser un fichier de mapping comme celui-ci : 
<?xml version="1.0"?> 

<!D0CTYPE mapping PUBLIC "-//EXOLAB/Castor Object Mapping DTD 
Version 1.0//EN" "http://castor.exolab.org/mapping.dtd"> 
<mapping> 

<cl ass name="com . bi ueweb . test . castor . DummyG ass" access="shared"> 
<map-to xmi="dummy-ciass"/> 
<fieid name="Age" type="integer"> 

<bind-xml name="age" node="attribute"/> 

</field> 

<field name="Name" type="java.iang.String"> 

<bind-xmi name="name" node="attribute"/> 

</fieid> 

</ciass> 
</mapping> 

Bien entendu, ce fichier est un des plus basiques possible, Castor permettant de 
faire des choses tres puissantes grace a ce fichier (et a ses API). 

Choisir un mode de serialisation 

Une fois maitrisees, il faut choisir entre les deux techniques et ce n'est pas une 
chose simple, car vient se poser l'eternelle question (dilemme) entre genericite et 
rapidite. En effet, comme toute operation basee sur l'introspection Java, la pre- 
miere option se veut independante de tout fichier et peut done s'adapter a 
n'importe quel contexte (done rapide a mettre en oeuvre et simple) mais s'avere 
plus lente que la seconde option utilisant un fichier de mapping. 
Pour BlueWeb, un autre argument prend encore plus d'importance et devient 
determinant dans le choix de la seconde solution. En effet, jusque-la nous avons 
passe sous silence que l'argument lie a l'introspection est le fait de s'adapter a toute 
situation (n'importe quel objet Java ou document XML) mais que se passe-t-il 
dans notre applicatif si cette etape n'est pas maitrisee ? Cet argument n'a aucun 
interet et se transforme peut-etre en inconvenient majeur car l'equipe de BlueWeb 
tient a garder une parfaite maitrise sur le fonctionnement de son application. . . En 
plus, la difference de performances permet de ne pas payer trap cherement ces 
etapes ajoutees artificiellement de serialisation/deserialisation. 
Voila, avec tous ces elements, nous serons en mesure de mettre en oeuvre au sein 
d'une servlet et au niveau du client la « tuyauterie » necessaire a une serialisation 
Java <-> XML. 

II convient de veiller a divers aspects lors de tels choix techniques : 

• volume des donnees transporters (devient un handicap dans le cas d'applica- 
tions distantes et de medias a faibles bandes passantes) ; 

• temps processeur requis par ces transformations (qui est un obstacle a la 
montee en charge du cote serveur) ; 

• facilite d'utilisation et impact sur votre code - il est en effet dangereux de 
modifier vos objets pour les adapter a la facon dont ils vont etre serialises, car 
que se passera-t-il si vous changez de produit ? 



PERFORMANCES Castor 

On recommande au lecteur de se livrer a un 
petit test avec un chronometre (2 System. 
currentTimeMillisO) et de serialiser/de- 
serialiser une masse importante de donnees 
(disons 5 000 objets), et ce en utilisant les deux 
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OUTIL Axis 



L'ancien projet Apache-SOAP est maintenant 
(depuis la sortie de la version 1 .0) devenu Axis. Ce 
projet permet de tester SOAP en s'integrant dans 
un moteur de servlet du type Tomcat. 
► http://xml.apache.org/axis/ 



OUTIL Glue 



► http://www.webmethods.com 



Une autre approche avec SOAP 

Le monde du Web ne parle plus que de SOAP (Simple Object Access Protocol), 
alors pourquoi ne pas l'utiliser ? L'equipe BlueWeb ne vient-elle pas de reinventer 
la roue avec ce framework utilise sur le protocole HTTP puisqu'il s'agit d'une 
forme de distribution d'objets sur HTTP via XML, ce qui est precisement le but 
de SOAP En effet, la finalite est la meme, mais ecarter SOAP de la discussion ne 
veut pas dire ne pas s'en preoccuper. 

SOAP est une solution qui n'est que l'avant-coureur des web services de demain. 
Seduisante dans l'esprit, cette solution n'est pas exempte de problemes : 

• lente car trop verbeuse pour une reelle utilisation sur Internet ; 

• trop generique done tres limitative en termes de programmation (pas de 
support des collections) ; 

• prise en charge de la serialisation XML cote client vite problematique (ecri- 
ture des serializers quasi obligatoire) ; 

• promesse de decouverte dynamique des services loin d'etre tenue. 

II reste que SOAP tient ses promesses au moins dans le domaine du developpe- 
ment cote serveur, puisque le code serveur n'est en rien lie a SOAP (juste 
deploye en tant que service web ). 

La bonne solution actuellement au niveau des implementations SOAP se situe 
peut-etre au niveau de Glue, qui dispose de nombreux atouts par rapport a ses 
concurrents directs, dont une veritable aide au developpement, des perfor- 
mances bien plus acceptables (largement superieures a Axis) et une bonne docu- 
mentation. Mais ce produit qui, malheureusement, est amene a disparaitre, est 
dote d'une licence tres speciale pouvant etre une entrave a son utilisation. 
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En resume 



L'ouverture et la portabilite impliquent fatalement des repercussions sur la vitesse 
de reponse dune application, mais le jeu en valant la chandelle, il est important de 
tirer parti de bibliotheques performantes pour amener a notre application cette 
ouverture sur l'exterieur si precieuse, et ce sans deteriorer trop les performances. 
L'utilisation de servlets pour assurer cette fonction de presentation est assez inte- 
ressante car c'est une technologie assez simple, robuste et tres efficace. En la con- 
juguant avec le design pattern Commande on vient de mettre en place a peu de 
frais un systeme evolutif et assez elegant. Vbila de quoi relever le challenge des web 
services. Au hasard d'un regard un peu attentif sur le pattern Commande, nous 
avons pu nous interesser a une des forces de JBoss : les Intercepteurs. 
L'examen du problem e de la serialisation d'objets nous a donne l'occasion de faire un 
petit detour par la problematique des web Services et de constater a quel point il est 
regrettable de n'en etre qu'aux tatonnements de ce qui est la technologie du futur 
(surement proche) : SOAP. Les lecteurs interesses par le sujet peuvent voir en 
XML-RPC un compromis plus realiste, puisque cette technologie offre des perfor- 
mances superieures a celles de SOAP mais au detriment des ambitions affichees. . . 



Couche metier avec les EJB 



Le developpement d'EJB pour coder rimplementation de la 
couche metier peut se reveler tres laborieux si Ton n'utilise pas 
d'outils nous permettant de nous concentrer sur « l'essentiel » 
sans se perdre dans le fatras de details. Ce chapitre presente de 
tels outils tout en donnant les bases du developpement d'EJB. 
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Rappels sur les EJB 



REFERENCE 



L' excellent ouvrage Mastering EJB (Roman etal.) 
traduit sous le titre EJB fondamental (Eyrolles 2002) 
peut etre telecharge en anglais au format PDF sur 
le site suivant : 

► http://www.theserverside.com 



ATTENTION Portability du code 

II faut bien comprendre que dans le lot de 
fichiers necessaires au deploiement d'un EJB, 
une partie seulement de ces fichiers est assuree 
d'etre reutilisable d'un conteneur a un autre. 
Suivant le serveur d'applications utilise, vous 
devrez adapter une serie de fichiers de configu- 
ration afin de pouvoir deployer vos composants. 
Vous devez bien comprendre cette notion si 
vous devez assumer une phase de migration de 
serveur d'applications et vous devrez a ce 
moment-la etre a meme de quantifier les delais 
necessaires a cette migration. 



Cette section est consacree aux rappels des principes fondamentaux regissant le 
codage des composants metier via la norme EJB. II ne s'agit que d'un guide ope- 
ratoire et non d'un tutoriel dont le volume et la complexite depasseraient large- 
ment le cadre de cet ouvrage. 

Vbici les differents types de composants mis a disposition par la specification 
EJB (version 2.1) : 

• Les beans de type session. Ce sont des composants dans lesquels vous allez 
coder la logique metier relative a tel ou tel sujet. lis ont un role de chef 
d'orchestre et vont souvent gerer les interactions entre plusieurs composants 
de type entite. lis peuvent etre du type statef ul (avec etat), c'est-a-dire per- 
mettant de simuler une notion de contexte utilisateur, ou alors stateless 
(sans etat), c'est-a-dire que d'une invocation a l'autre notre composant est 
recycle par le serveur d'applications (et done reinitialise). 

• Les beans de type entite. lis correspondent a une ligne d'une table d'une 
base de donnees et representent des entites de notre modele physique de 
donnees. Ces donnees persistantes peuvent, elles aussi, etre de deux types. 
Avec le type CMP (Container Managed Persistency), le conteneur se charge 
seul de la lecture/stockage de notre entite en base de donnees. Avec le type 
BMP (Bean Managed Persistency), e'est au developpeur que revient la 
charge de la persistance des donnees. Ce type de composants est developpe 
via une utilisation massive de JDBC. 

• Les clients JMS. Ce nouveau type de composants permet de creer des 
clients de files de messages professionnelles telles que MQ^Series (IBM) ou 
MS-MQ_ (Microsoft). Ces clients seront abonnes a des sujets proposes par 
moteur de messages. 

Nous allons etablir ici une liste succincte des differents acteurs que nous devrons 
coder, tout en rappelant le role de chacun d'entre eux au sein de l'ensemble. 
Pour faciliter ce rappel, nous utiliserons l'exemple classique du compte bancaire 
avec une classe denommee Compte. 

• Classe implementation : CompteBean, e'est la classe dans laquelle nous 
devons placer le code correspondant a la logique metier (comment se traduit 
une ouverture de compte, une fermeture de compte ou encore un debit d'une 
somme sur ce compte). 

• Home interface : CompteHome permet de localiser et de manipuler (findAll 
ou findByPrimaryKey) les instances de notre classe Compte. 

• Remotelnterface : e'est cette interface qui va etre manipulee par le client. 
Elle contient done la liste de tous les services disponibles (implementes dans 
la classe CompteBean). 

• Le fichier ejb-jar.xml, ou fichier de description de deploiement (deploy- 
ment-descriptor), permet d'empaqueter les composants en une unite (fichier 
jar) qui va etre deployee au sein du serveur d'applications. C'est dans ce 
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fichier que Ton va enoncer les contraintes de securite vis-a-vis de nos com- 
posants, ainsi que les contraintes liees a la gestion des transactions (voir sec- 
tion assembly-descriptor de ce fichier). 

Ceci represente la partie portable et independante de la version de la specifica- 
tion utilisee lors du developpement/deploiement, c'est-a-dire la partie minimale 
du travail a effectuer, et ce pour chaque composant (meme si en fait on n'a en 
verite qu'un seul fichier ejb-jar.xml par application, il faut quand meme le 
mettre a jour). 

Maintenant, il faut constater que chaque serveur d'applications QBoss, 
Weblogic, Websphere...) requiert d'autres informations avant de deployer votre 
composant. C'est la part non portable, d'un serveur a l'autre, du travail a effec- 
tuer. 

Ceci fait, nous pouvons passer au deploiement en lui-meme, qui bien entendu 
n'est pas normalise (done chaque serveur d'applications proposera sa facon de 
faire...). Ceci peut aller de l'application graphique pour des serveurs comme 
Websphere a la simple copie de fichiers dans un endroit donne (pour JBoss, voir 
repertoire deploy). 

Ceci peut se traduire en resume par un schema directeur du developpement 
cadence en trois etapes : 

1 codage des composants ; 

2 modification/creation du fichier de description du deploiement ; 

3 Packaging/ Abplolzmznt. 

Maintenant que ces grandes etapes sont rappelees, revenons sur la partie codage. . . 

Les trois classes enoncees ci-dessus necessaires au codage d'un composant, sont 
en fait souvent plutot juste la partie basique necessaire, mais elles peuvent etre 
completees par d'autres classes, a savoir : 

• CompteData, une classe dite holder ou value object, permettant de rassembler 
en un seul element transportable par le reseau toute l'information necessaire 
a la caracterisation de l'instance specifique du composant auquel elle est rat- 
tachee. Cela signifie que Ton va rassembler, sous forme d'une instance d'une 
classe CompteData, toute l'information caracterisant une instance de la classe 
Compte. Pour plus d'informations sur ce precede, se reporter a l'encadre dedie 
a cet effet. 

• Pour les composants deployes dans des conteneurs EJB appliquant la specifi- 
cation EJB 2.1, la norme CMP 2.1 {Container Managed Persistence) permet 
de creer des vues non plus seulement des nos objets destines a une utilisation 
via le reseau (serialisation par le protocole RMI/IIOP), mais aussi des objets 
dits « locaux ». Ces objets pourront etre manipules par reference (pointeur 
direct comme dans tout programme Java). Ceci implique un gain de perfor- 
mance mais nous oblige a coder deux autres classes : CompteLocal et 
CompteLocalHome, qui seront done la Local Interface (pendant de la 
Remotelnterf ace) et la Local Home interface (pendant de la Home interface). 



LEGENDE URBAINE Les outils graphiques 

II s'agit d'un piege trap souvent utilise par les ven- 
deurs d'outils, qui sont prompts a proposer de 
nombreux outils graphiques avec lesquels en quel- 
ques dies de souris vous pouvez faire ceci ou cela. 
Attention, ce type d'outils est extremement dange- 
reux, car ils sont de reelles entraves a la bonne 
comprehension des mecanismes sous-jacents et 
rendent impossible I'automatisation de certaines 
taches d'administration. L'avantage que peut y 
trouver un debutant, s'avere vite etre une entrave 
pour le professionnel. En revenant au cas precis 
des outils graphiques permettant le deploiement 
des EJB dans un serveur d'applications, il faut bien 
comprendre que ce type de solutions s'avere pro- 
blematique lorsqu'il s'agit de redeployer a distance 
une version de vos composants. Ce cas de figure 
est exactement celui que vous rencontrerez en 
clientele et il faut anticiper ce type de situations. 
L'utilisation d'un script est une solution beaucoup 
plus simple a mettre en ceuvre pratiquement, car 
vous pourrez aisement demander un acces par 
ssh, vous permettant de vous connecter a dis- 
tance et de lancer votre script. La mecanique de 
deploiement d'EJB offerte par JBoss est d'une effi- 
cacite et d'une simplicity exemplaires, meme si elle 
semble manquer de belles interfaces graphiques. 



ATTENTION Compatibility 

de votre serveur d'applications 

avec une version des specifications 

Quasimenttout estdit dans le titre. . . II faut faire 
bien attention aux deboires rencontres lors d'un 
changement de serveur d'applications, car cer- 
tains produits, comme Websphere, ne prennent 
en charge a I'heure actuelle que la version 1.1 
des specifications des EJB. La migration d'un 
produit acceptant les EJB 2.0 vers un produit 
n'appliquant que les EJB 1 .1 ne se fait pas sans 
douleurs. 
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DESIGN PATTERN ValueObject 

Le design pattern ValueObject voit ses origines 
dans les premiers frameworks de distribution 
d'objets sur un bus de donnees comme Corba. 
La problematique sous-jacente a la creation de 
ce design pattern n'est done pas recente et ce 
principe gouverne toutes les architectures utili- 
sant des objets distribues. Nous sommes la dans 
un contexte ou le client et le serveur sont dans 
I'absolu situes sur des machines differentes et 
les communications entre ces deux composants 
soumises a une contrainte non negligeable : le 
media de transport (connexion telephonique, 
NUMERIS, fibre optique ou reseau 10 Mb sont 
autant de conditions differentes d'execution en 
termes de bande passante et done de satura- 
tion). Admettons que dans le contexte de I'objet 
Compte, chaque compte ait un attribut avec le 
nom du titulaire de ce compte (type string), 
un identifiant (entier sur 10 chiffres), un decou- 
vert maximum autorise (type float) et un 
champ remarque (string) permettant au 
charge de compte de stacker divers commentai- 
res. Une application de gestion pourrait avoir 
besoin pour un affichage, du nom du titulaire et 
de I'identifiant du compte, ainsi que du decou- 
vert maximal autorise... Naivement, on pourrait 
penser depuis le client faire getNom(), puis 
getld(), puis enfin getMaxAutO sur la refe- 
rence de notre objet Compte. Helas, e'est une 
approche trop naive ! ! ! En effet cette facon de 
faire aurait I'effet desastreux de provoquer trois 
requetes sur notre reseau (une pour chaque 
appel du type getAttributO). L'idee est 
done simple, il nous suffit de concentrer cette 
information en une seule et meme classe puis 
de remplacer notre serie d'appels par : 
getValueObjectQ. 



Dans un cas aussi simple, I'implementation des ► 
services Test forcement aussi... Ici on se con- 
tente d'une multiplication par le taux de base de 
conversion... 

Cette classe est la classe d'implementation des 
services de notre composant (conversions). 
On peut se demander si ce n'est pas la seule 
utile... 



DESIGN Pourquoi choisir ('utilisation d'entites en mode CMP ? 

Cette question vaut un eclaircissement. Premierement, il est logique de commencer par essayer 
de tirer parti pleinement de la puissance de son conteneur et d'essayer de minimiser son travail. 
L'ecriture d'un code ayant trait au domaine de la persistance et des bases de donnees est une 
tache ardue, voire un challenge si Ton cherche a ne pas se coupler a un moteur de base de don- 
nees. L'ecriture de code performant est difficile dans le sens ou ce domaine technique est issu 
directement des mathematiques ensemblistes. Le desir d'independance par rapport a la base 
devient vite une contrainte si Ton considere la pauvrete de la norme ANSI SQL 92. Tout cela 
montre qu'une telle tache ne doit pas etre commencee a la legere. De plus, le conteneur peut 
beneficier d'avantages considerables en termes de performances avec ce qu'il est convenu 
d'appeler le probleme des « (n+1) requetes » (de la documentation est disponible sur de nom- 
breux sites ou forums pour expliquer plus avant ce probleme). Deuxiemement, le fait de com- 
mencer par utiliser un tel composant n'implique pas le deploiement au final de ce composant, 
car si vous vous heurtez a un des cas de figure pour lesquels I'approche par CMP s'avere proble- 
matique, il ne tient qu'a vous de remplacer cette classe par une classe assurant elle-meme sa 
persistance (BMP). II s'agit la encore d'une approche pragmatique, peut-etre decriable aux yeux 
de certains integristes, mais qui doit vous permettre de trouver le juste equilibre entre perfor- 



Un petit exemple de bean de session : un convertisseur 
d'euros 

Tout cela etant bien theorique jusque-la, rapprochons-nous du code par le biais 
d'un exemple tres simple, mais qui nous permettra de mettre en evidence le tra- 
vail necessaire au deploiement d'un EJB dans un conteneur. Reprenons 
l'exemple utilise lors du chapitre 3 : le convertisseur monetaire, euros vers francs 
et vice versa. II peut etre parfaitement justifie, dans le cadre d'une application 
amende a manipuler des monnaies, d'avoir a utiliser un composant de ce type. 

Quel est le code necessaire pour realiser ce composant ? Quels sont les fichiers 
guidant le deploiement ? 

Implementation des services 

Ce bean de session tres simple propose un seul service, le calcul d'une conver- 
sion franc vers euro ou euro vers franc. II n'a d'autre utilite que de montrer 
l'enorme travail que requiert le deploiement d'un EJB. Bien entendu, etant 
donne la nature simpliste de ce composant, il n'a pas d'interactions avec l'exte- 
rieur, et ne necessite done pas de dialogue avec d'autres EJB... 




package test.ejb; 
import javax.ejb.*; 

public class ExempleSessionBean implements SessionBean { 



private float tauxDeBase = 6.55957f; 

/** 

* Calcul euro vers franc 

* @param aConvertir, montant a convertir (euros) vers des francs 

* ©return somme convertie en francs 

V 
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public float euroToFranc (float aConvertir) { 

System. err. print~ln("conversion de " + aConvertir + " euros vers des 
francs") ; 

return aConverti r*tauxDeBase ; 

} 



/ 



Calcul de la conversion francs vers euros 
@param aConvertir, montant en francs a convertir en euros 
©return somme convertie en euros 

V 

public float francToEuro(float aConvertir){ 

return aConverti r/tauxDeBase; 

} 

public void ejbActivate() { 

} 

public void ejbPassivateO { 



} 



} 

public vo 

} 

public vo 

} 

public void ejbCreate(){ 

} 



d setSessionContext(SessionContext ctx) { 
d ejbRemove() { 



Cette classe a pour vocation de fournir l'implementation des services offerts par 
notre composant. Les methodes de conversion ont ete mises en evidence, le res- 
tant du code est la « plomberie » classique dans ce contexte des EJB. Les 
methodes ejbRemoveO, ejbActivateO et affiliees seront implementees pour 
nous par le conteneur EJB. Le seul contexte induisant une implementation 
explicite de ces methodes est celui d'entites en mode BMP. 

Les services etant tres simples, les commentaires sont quasiment superflus. II 
suffit d'operer une multiplication (division) par notre taux de conversion puis de 
retourner cette valeur. Rien de plus simple... 



Les methodes suivantes sont en rapport avec le 
cycle de vie des objets au sein du conteneur EJB : 
activation, passivation, creation ou destruction. 
II n'y a rien a faire dans les cas d'activation, pas- 
sivation, creation ou destruction, de meme que 
le contexte est ici indifferent. 



RAPPEL Bean Managed Persistence 

En mode BMP, il incombe au developpeur d'assu- 
rer lui-meme la persistance de ses objets. 



Home Interface 

Cette classe permettra d'appeler des services basiques (creer un objet par 
exemple). Elle est essentielle mais n'amene aucune nouveaute (surtout dans le 
cadre d'un EJB session). Dans le cadre d'un EJB entite, on y trouverait des 
methodes permettant de trouver un objet en particulier, ces methodes sont dites 
finder dans le jargon... Le but de ce code est de montrer l'aspect rebarbatif du 
codage d'EJB a la main : le code ci-apres ne contient pas la moindre ligne de 
code Java utile et des declarations redondantes par rapport au code precedem- 
ment expose. Tout cela pour si peu ! 
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Home interface du bean ExempleSession. Peu 
de services dans le cadre d'un EJB session, si ce 
n'est la seule methode createQ. 



Cette methode cree et renvoie un objet du type 
ExempleSessionRemote. II faudra necessai- 
rement appeler cette methode sur un objet du 
type ExempleSessionHome avant de pouvoir 
appeler nos services de conversion, et ce afin de 
manipuler un proxy correct. 



Home interface rattac 

package test.ejb; 

public interface ExempleSessionHome 
extends javax.ejb.EDBHome 

{ 

public static final String COMP_NAME="java:comp/env/ejb/ 

ExempleSession"; 
public static final String ]NDI_NAME="ejb/exemple/session" ; 

public test.ejb.ExempleSessionRemote create() 

th rows j avax . e j b . CreateExcepti on , j ava . rmi . RemoteExcepti on ; 

} 

Le commentaire general est edifiant : pas la moindre trace de code utile, uni- 
quement des declarations pouvant etre faites automatiquement... 



II s'agit du proxy nous permettant d'invoquer les 
methodes offertes par notre objet distribue sur 
le reseau. On ne s'etonne done pas de retrouver 
les declarations de nos deux services 
euroToFrancQ et f rancToEuroQ. 



Les methodes sont bien celles exposees par 
notre Bean. Notez la levee possible d'une excep- 
tion detype RemoteExcepti on. 



DESIGN PATTERN Proxy 

Ce design pattern est tres celebre en raison de 
son utilisation systematique dans toute archi- 
tecture ou il y a distribution d'objets sur un 
reseau. En caricaturant, le principe de ce design 
pattern est d'utiliser un effet « Canada-dry » 
(« cela a la couleur de I'alcool, mais ce n'est pas 
de I'alcool »), e'est-a-dire de faire croire au 
client qu'il invoque un service sur un objet qu'il 
peut manipuler alors qu'en fait celui-ci ne fait 
que relayer la requete a un objet situe peut-etre 
sur une autre machine. Ce principe permet de 
camoufler au programmeur les difficultes liees a 
la programmation en reseau : protocoles, 
sequencement des caracteres (LITTLE-ENDIAN 



Remote Interface (interface distante) 

Cette classe permettra d'invoquer les services de notre objet a distance, puisqu'il 
faut bien garder a l'esprit qu'un client EJB peut etre situe a n'importe quel 
endroit du reseau (done sur une toute autre machine que celle hebergeant le 
conteneur EJB). Notre proxy expose les memes services que ceux definis dans le 
composant d'implementation (calcul franc vers euro et euro vers franc). 

package test.ejb; 

public interface ExempleSessionRemote 
extends javax.ejb.EDBObject{ 



public float euroToFranc( float aConvertir ) 
throws java.rmi .RemoteException; 

public float francToEuro( float aConvertir ) 
throws java.rmi .RemoteException; 



} 



La raison d'etre de cette classe est de fournir un « proxy » de l'objet distribue sur 
le reseau (notre classe ExempleSessionBean.java). 

Le design pattern Proxy 

Le design pattern Proxy permet de mettre en oeuvre un des principes majeurs uti- 
lises en programmation objet : la delegation. Sans chercher a entrer dans l'eternel 
debat heritage/delegation, l'utilisation de la delegation a le merite tres clair de 
delester l'utilisateur de problemes qui ne sont pas les siens. Ce pattern est utilise 
systematiquement dans les architectures utilisant des objets distribues (Corba ou 
EJB par exemple) mais ne se cantonne pas a cette seule utilisation. Ainsi, le recent 
avenement de l'AOP (programmation orientee aspects) permet de comprendre 
tout l'interet de cette approche. On peut signaler en passant que JBoss est code 
avec une telle approche et fait une consommation massive de proxies dynamiques. 
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On peut synthetiser le principe general de ce motif de conception par le dia- 
gramme de sequences UML de la figure 5-1. 




«description» 
Diagramme de principe 
du design pattern Proxy. 



Figure 5-1 

Le design pattern Proxy 



L'interet majeur est de manipuler un objet (le proxy) qui encapsule la complexite 
du contexte et qui nous detache de l'implementation utilisee finalement. Ainsi, 
si Ton change l'implementation de la methode convertisO dans notre classe 
Converti sseur, l'objet proxy sera identique et done le code client pourra rester le 
meme. Depuis le JDK 1.3, Java prend en charge ce concept de proxies avec 
notamment la classe java. Tang, reflect. Proxy. II est interessant de montrer la 
puissance de ce mecanisme en action sur un exemple simple. Dans l'exemple 
suivant, nous allons ajouter des fonctionnalites elementaires en matiere de trace, 
et ce sans modifier notre classe centrale. Soit l'interface suivante : 

Une interface tres simple 

package test. proxies; 
public interface ISimple { 

public String getNomO; 

public String getCommentaireO ; 

} 

II s'agit d'une interface quelconque, dont une implementation type (tres simple) 
est fournie ici : 

Implementation de notre interface ISimple 

package test. proxies ; 

public class Simplelmpl implements ISimple { 
public String getNomO { 

System. err. println("SimpleImpl : :getNom() je vais retourner le nom"); 
return "Simple"; 

} 



Cette interface n'a d'interet que pour l'exemple 
et propose deux services elementaires. 



Classe implementant les services definis dans 
l'interface ISimple. On peut noter le nom 
Simplelmpl, oil Impl signifie implementation. 
Cette convention est souvent utilisee. 
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} 



public String getCommentaire() { 

// difficile de f ai re plus simple... 
System. err. println("SimpleImpl : :getCommentai re() je vais retourner 
le commentai re") ; 
return "sans commentai re" ; 

} 



Pour ajouter des fonctionnalites de trace basiques, il suffit de creer un proxy (ici 
statique pour rester simple) dont le code est le suivant : 



Classe de test montrant comment ajouter un 
niveau de trace basique a un objet par ce design 
pattern. 



Ce proxy va ajouter des fonctions de trace de 
tres bas niveau. Chaque appel de methode sur 
I'objet delegue par le biais de ce proxy se verra 
precede d'un message ; de meme qu'a la sortie 
de chaque methode. 



II s'agit la d'une Factory : cette methode sert a 
creer des references. Elle est indispensable vu le 
caractere prive du constructeur. 



Ligne de code un peu brutale au premier 
abord... II s'agit de creer un proxy ajoutant la 
fonctionnalite de trace basique. Pour cela, on 
utilise la classe standard Java (depuis le JDK 1 .3) 
Proxy, en lui precisant le chargeur de classes a 
utiliser, I'interface implemented par I'objet ainsi 
que la classe fournissant le type de proxy que 
nous attendons (ajout de traces). 



package test. proxies; 

i mport j ava . 1 ang . ref 1 ect . Invocati onHandl e r ; 
import java.lang. reflect. Method; 
import java.lang. reflect. Proxy; 

public class TraceurProxy implements Invocati onHandl er { 

// objet sur le lequel on agit 

// tous les appels a la methode invoke() (voir plus bas) 
// induiront 1 'appel d'une des methodes de cet objet. 
private Object delegue; 

// constructeur prive pour eviter des 
// appels directs 

private TraceurProxy(Object unObjetDelegue){ 
del egue=unObj etDel egue ; 

} 

/** 

* @param unObjetDelegue, objet vers lequel on va rediriger 

* les requetes * ©return Object, on va creer des objets modifies 

* @see Proxy#newProxyInstance() 

V 

public static Object createlnstance(0bject unObjetDelegue){ 

return Proxy. newProxyInstance( 

unObjetDelegue. getCl ass() .getClassLoader() , 
unObjetDelegue. getCl ass() .getlnterfaces() , 
new TraceurProxy(unObjetDelegue)) ; 

} // createlnstanceO 

/* @param unProxy, le proxy utilise 

* @param uneMethode, la methode invoquee par le client 

* @param args, arguments transmis 

* @see 

* j ava . 1 ang . ref 1 ect . Invocati onHandl e r#i nvoke ( j ava . 1 ang . Ob j ect , 
* java.lang. reflect. Method, java.lang. Object[])*/ 

public Object invoke(Object unProxy, Method uneMethode, Object[] args) 
throws Throwable { 
Object return_object = null; 
try{ 
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System. out. println("]e vans rentrer dans la methode = " + 

uneMethode.getNameO) ; 
return_object=uneMethode . i nvoke(del egue , args) ; 
System. out. println("Je suis sorti de la methode "+ 

uneMethode.getNameO) ; 

} 

catch (Exception e){ 

System. err. pn'ntln("Une erreur inattendue s'est produite 
e.getMessageO) ; 

} 

return return_object; 
} // invoke () 



Pour illustrer tout cela, codons une classe de test mettant tout en oeuvre. 



Ici, grace a la delegation, on peut se contenter 
d'encadrer I'appel (delegation) de la methode 
par notre code de trace. 



Classe d'illustration de la 

package test. proxies; 

/** 

* Une classe principale montrant nos proxies en action... 

* ©author j .moliere 

V 

public class Main { 

public static void main(String[] args) { 

ISimple simp1e= (ISimple) TraceurProxy.createInstance( 

new Simplelmpl ()) ; // on appelle la methode getNom() 
simple. getNomO ; 

// on appelle la methode getCommentai re() 
simple.getCommentai re() ; 
} // mainQ 



En la lancant (par java test. proxies. Main), on obtientune sortie du type : 

]e vais rentrer dans la methode = getNom 
Simplelmpl : :getNom() je vais retourner le nom 
]e suis sorti de la methode getNom 
]e vais rentrer dans la methode = 

getCommentai reSimplelmpl : :getCommentai re() je vais retourner le 
commentai re 

]e suis sorti de la methode getCommentai re 

En bref et pour conclure sur cet aparte a propos du motif de conception Proxy, il 
faut retenir que par cette architecture, vous pouvez obtenir un exemple de con- 
ception vous camouflant une complexite parfois enorme (comme c'est le cas 
dans le contexte d'une utilisation d'un middleware comme Corba) et protegeant 
votre code client d eventuelles modifications dans les objets delegues (puisque 
vous ne savez rien d'eux). 



Ici I'objet simple est en fait un proxy sur une ins- 
tance de la classe Si mpl elmpl (qui implemente 
I'interface ISimple). Ce proxy ajoute les fonc- 
tionnalites de trace esperees. 



On cree un proxy en passant par cette methode 

statique. On ajoute des fonctionnalites sans rien 

changer a I'utilisation de notre objet ! 

On est oblige d'utiliser I'operateur de cast car le 

type statique de retour est java.lang. 

Object. 

L'objet delegue est ici une instance de notre 
implementation de I'interface Isimple. 



B.A.-BA AOP 
(Aspect Oriented Programming) 

La programmation orientee aspects a pour but de 
simplifier la maintenance de code en separant 
strictement logique metier et decorations techni- 
ques (code de traces, logging, authentication, 
etc.). C'est un domaine passionnant et relative- 
ment meconnu encore. Un outil Java proposant 
cette approche est librement disponible sur le site : 
► http://www.aspectj.org. 
03 R. Pawlak et al., Programmation orientee aspect 
pourJavalME, Eyrolles, 2004. 



107 



Description du deploiement 



Attention, ce fichier est valide avec une DTD offi- 
cielle de Sun. II permet de standardiser le 
deploiement et I'assemblage d'EJB au sein d'un 
conteneur EJB. 



Une premiere partie generale avec des informa- 
tions de description... 



Descripteur de deploiement. 



Cette section rassemble tous vos EJB (MDB, enti- 
tes ou session). 



<?xml version="1.0" encodi ng="UTF-8"?> 

<!D0CTYPE ejb-jar PUBLIC "-//Sun Microsystems, Inc. //DTD Enterprise 
JavaBeans 2.0//EN" "http://java.sun.com/dtd/ejb-jar_2_0.dtd"> 

<ejb-jar > 

<description><! [CDATA[No Description. ]]></description> 

<display-name>Descripteur de deploiement pour notre bean de session 

exemple</di splay-name> 
<enterprise-beans> 

<!-- Session Beans --> 

<!-- session reduite a un seul bean --> 
<session > 

<description><! [CDATA[exemple bean session]]x/description> 



B.A.-BA JNDI 

JNDI est une API de Sun dont la vocation est de resoudre les problemes 
de recherche d'objets. II s'agit de proposer une reponse a la problemati- 
que des services de nommage. On peut utiliser une analogie avec une 
bibliotheque ou Ton associe a un nom d'ouvrage (disons : I'art de la 
guerre de Sun Tzu) un emplacement dans des rayons (par exemple B3). 
Une application utilisant des objets distribute va necessiter le meme 
type de services puisqu'une partie cliente va utiliser un nom d'objet de 
maniere a le localiser, puis va invoquer une methode (ou plusieurs) sur 
I'objet obtenu apres recherche. La terminologie anglaise veut que Ton 
utilise le terme de « binding » pour designer I'association faite entre un 
nom et un objet. Pour en revenir a notre exemple, on a associe au nom 
ejb/test/ExempleSession la classe Java test.ejb. 
ExempleSessionBean. Ce mecanisme vous est forcement familier 
(sans le savoir) car I'exemple le plus celebre de service de nommage est 
sans aucun doute DNS, I'outil rendant possible I'utilisation simple 
d'lnternet, puisqu'il permet d'associer a un nom (www.javasoft.com) 
une adresse IP (celle du serveur web honorant les requetes pour ce nom 
de domaine). Dans un domaine plus proche des EJB, Corba dispose avec 
le COS d'un service de nommage tres puissant mais assez difficile 
d'approche. On peut citer un autre type de service de nommage avec le 
protocole SMB de Microsoft, qui permet d'acceder a des machines au 
sein d'un reseau Microsoft (avec la convention de nom UNC du type 
\\nom_machine). 

Pour les habitues de Java-RMI (objets distribute en environnement 
Java), il est bon de preciser que JNDI est une API tres simple a mettre en 
ceuvre puisqu'ils retrouveront la plupart des methodes de I'objet 
Nami ng a travers I'objet j avax .naming. Context. 
II est utile de preciser d'emblee qu'il faut voir JNDI plus comme une 
interface que comme une implementation de service de nommage, 
dans le sens ou cette API vous permet, en parametrant votre contexte 
(j avax. naming. Initial Context), de questionner des services de 
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H (3 Reseau Microsoft Windows 
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Imprimantes et telecopieurs 
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B 5 Mini 
:+ : J dvpt sur Samba Server (Buggy) 
EE V jerome sur Samba Server (Buggy) 
♦ v Mes Sites Web sur MSN 
EE J public sur Samba Server (Buggy) 
l) Corbeille 

Figure 5-2 Un exemple de service de nommage en action : 
le voisinage reseau Microsoft 

nommage tels que LDAP, NIS, COS. Ceci explique le fait que la premiere 
ligne d'un bloc de code dedie a la recherche d'objets via JNDI soit du 
type: 

Hashtable env = new HashtableO; 

env . put (Context . INITIAL_CONTEXT_FACTORY , 

"com . sun . j ndi . f scontext . Ref FSContextFactory") ; 
Context ctx = new InitialContext(env) ; 
lei env va designer une table associative (hashtable) au sein de laquelle 
on definit une implementation particuliere permettant de creer des 
objets du type Initial Context. Cette section est a comparer avec le 
debut du programme client permettant d'invoquer un EJB session 
deploye au sein de JBoss. 
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<ejb-name>Exempl eSessi on</ejb-name> 
<home>test . e j b . Exempl eSessi onHome</home> 
<remote>test . ej b . Exempl eSessi onRemote</ remote> 
<ejb-class>test.ejb. Exempl eSessionBean</ejb-class> 
<session-type>Stateless</session-type> 
<transaction-type>Container</transaction-type> 
</session> 

<!-- Entity Beans — > 

<!-- Message Driven Beans --> 
</enterprise-beans> 
<!-- Relationships — > 
<!-- Assembly Descriptor — > 

ossembly-descriptor > 

<!--To add additional assembly descriptor info here, add a file 
to yourXDoclet merge directory called assembly-descriptor. xml that 
contains the <assembly-descriptorx/assembly-descriptor> markup. --> 

<!-- finder permissions --> 

<!-- transactions --> 

<!-- finder transactions — > 

</assembly-descriptor> 
</ejb-jar> 

Ce fichierXML est standardise par la normeJ2EE. II est nomme ejb-jar.xml). 
II sera done utilise par n'importe quel conteneur EJB. Malheureusement, il ne 
suffit pas et doit etre complete par un (ou plusieurs) fichier(s) specifique(s) au 
conteneur que vous utilisez. 

Dans le cas de JBoss, le fichier necessaire est nomme jboss.xml) : 

Fichier de description propre a JBoss jboss.xml 

<?xml version="1.0" encoding="UTF-8"?> 

<!D0CTYPE jboss PUBLIC "-//JBoss//DTD JBOSS 3.0//EN" 

"http : //www. jboss . org/j 2ee/dtd/jboss_3_0 . dtd"> 
<jboss> 

<enterprise-beans> 
<! — 

To add beans that you have deployment descriptor info for, add 
a file to your XDoclet merge directory called jboss-beans .xml that 
contains the <sessionx/session>, <entityx/entity> and 
<message-drivenx/message-driven> markup for those beans. 
— > 
<session> 

<ejb-name>Exempl eSessi on</ejb-name> 
<jndi-name>ejb/exemple/session</jndi-name> 
<configuration-name>Standard Stateless SessionBean 
</configuration-name> 
</session> 
</enterprise-beans> 
<resource-managers> 
</resource-managers> 
</jboss> 



< | Section vide dans notre cas exemple. 

< | Pas d'EJB de ce type. 

< Cette section guide I'assemblage des EJB. Elle 
est ici reduite a neant car il n'y a qu'un seul 
EJB... 



A ce stade-la, il ne reste plus qua deployer l'application apres l'avoir empaquetee. 



! v Telnet 
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Mise en oeuvre de JBoss 



Nous allons ici donner les grandes lignes permettant de preparer le 
deploiement de vos applications au sein de JBoss. Pour cela, il suffit de : 

1 . Telecharger la derniere version de JBoss (format . zi p ou . tar . gz). 
Pour cela, le plus simple consiste a faire pointer votre navigateur 
web vers I'URL : 

► http://sourceforge.net/project/showfiles. php?group id=22866. 

2. Decompresser la version choisie sur votre machine. On ne peut que 
fortement conseiller d'utiliser un repertoire du type c:\jboss sous 
Windows (attention aux problemes lies aux espaces dans les noms 
de repertoires, done evitez c:\Program Files\]boss). 

3. Positionner une variable d'environnement JBOSSJOME pointant 
vers le repertoire choisi precedemment. Par exemple sous Unix (shell 
bash), modifiez ou creez un .bashrc dans votre repertoire person- 
nel (HOME_DIR ou ~) avec une ligne du type : 
export ]BOSS_HOME=/usr/local/jboss. Sous Windows, vous 
pouvez utiliser le panneau de configuration pour ajouter cette varia- 
ble. 

4. Utiliser le script de demarrage adapte a votre systeme (run.sh ou 
run . bat) dans le repertoire bi n de la distribution JBoss (par exem- 
ple c:\jboss\bin). 

£a y est, JBoss est pret a fonctionner. Comment s'assurer qu'il fonc- 
tionne correctement ? C'est assez simple, il suffit de tester que certains 
ports standards repondent correctement : 

• Sous Windows ou Unix, vous pouvez utiliser le programme telnet. 
En lancant un telnet buggy 1099 depuis ma machine mini (Win- 
dows), je peux m'assurer que le serveur JNDI est en place sur la 
machine serveur (Linux). 



Figure 5-3 Utilisation de Telnet sous Windows ou Unix pour 
s'assurer du bon fonctionnement de JBoss 

On obtient un ecran un peu bizarre (figure 5-3), une sortie peu 
exploitable mais c'est bon signe ! 

Sous Unix, on peut utiliser sur la machine serveur (celle hebergeant 
JBoss) le programme ps, permettant de lister les processus. Voici une 
capture d'une console Unix utilisant ce programme (figure 5-4). 
Enfin, la meilleure solution reste de tester grandeur nature avec une 
application. 



Figure 5-4 Le programme ps 
dans une console Unix 



omct? buggvjavaxpert.com 



Session TdHton Afflehaqp Cm 



ps aux | Krf>p java 
root 8170 O.S 11.1 280588 57072 pts/3 

jerone 300U2 0.0 0.1 3604 676 pts/2 



F«b27 

13:22 



28:39 /ubr/jiiva/j2*<Jkl. 
0:00 urep java 
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II ne reste plus qua creer une archive (.ear ou .jar) de maniere a deployer notre 
composant. Pour cela, rien de tel qu'utiliser les atouts offerts par Ant. 

Programme client de test 

Une fois tout cela empaquete (se reporter au build-file commente plus loin dans 
ce chapitre) et deploye dans JBoss, il nous faut un programme de test invoquant 
les methodes de conversion proposees par notre EJB. 

Programme client de notre EJB 



package main. client; 
i mport j avax . nami ng . Ini ti al Context ; 
import java.io.FilelnputStream; 
import java.util .Properties; 
import test.ejb.*; 

class SessionClient { 

/** 

* methode main() demontrant les etapes necessaires a 

* l'invocation d'un service sur un EJB: 

* - Initialise un contexte JNDI 

* - Opere la recherche de notre EJB session 

* - Obtient la home interface 

* - cree un bean de session 

* - puis invoque le service de conversion 



*/ 

public static void main(String[] args){ 
try { 

// cree un objet Properties 
Properties props = new PropertiesO; 
// charge le fichier jndi .properties 
props. load( new FileInputStream("jndi .properties")) ; 
// utilise cet objet pour initialiser le contexte JNDI 
// de recherche 

Initial Context jndiContext = new InitialContext(props) ; 
System. err. println("Initial context initialized"); 

// utilise ce contexte pour chercher notre bean session 
// attention a utiliser le bon nom 
ExempleSessionHome home = (ExempleSessionHome) 

jndiContext. lookup("ejb/exemple/session") ; 
// utilise la home interface pour obteni r un proxy sur notre EJB 
ExempleSessionRemote session = home.create() ; 
float montant=(float)1000f ; 
// procede a la conversion 
float francs=session.euroToFranc(montant) ; 
System. out. println("Conversion = " + francs); 

} 

catch (Exception x) { 
x . pri ntStackTraceO ; 

} 

} 



CROSS REFERENCE Build-file pret a I'emploi 

Vous trouverez dans la suite de ce chapitre un 
fichier Ant pret a I'emploi accomplissant de nom- 
breuses taches, dont notamment I'empaquetage 
d'une application. On ne peut que vous inviter a 
reprendre les sections de ce fichier dediees a cet 
usage. 



Cette classe montrant comment utiliser un EJB 
depuis un contexte client. 



On ne peut que preciser le caractere tres typique 
de ce programme de test. En fait, tous vos pro- 
grammes clients auront la meme structure, a 
savoir : initialisation d'un contexte JNDI pour 
permettre les recherches d'objets dans votre 
contexte particulier (serveur EJB utilise, port et 
nom de machine), puis obtention d'une Home 
interface de maniere a pouvoir creer ou recher- 
cher vos objets distants, puis appel aux services 
de vos EJB. 



111 



LU 
LU 

(N 

k. 

3 

at 

| En compilant (avec un CLASSPATH correct) et en lancant ce programme (par java 

& main.client.SessionGient), vous devez etre a meme d'observer une sortie du 

* type: 

■a 



Session tdition Attic haqe Contiquration Aide 


HI 


41i © rj rj rj rj 


java main . client .SessionClient 
properties loaded 
Tn i 1 inl rtintfxt lull IhI i/.Hi) 
Conversion = 6559.57 








Figure 5-5 Lancement du client 



L'execution de ce programme presuppose que vous fournissiez un fichier texte 
(jndi .properties) initialisant le contexte des recherches JNDI. Ce fichier doit 
etre dans le repertoire a partir duquel vous lancez le programme. 

Void le contenu de ce fichier : 

j ava . nami ng . factory . i ni ti al =org . j np . i interfaces . Nami ngContextFacto ry 
j ava . nami ng . provi de r . u ri =1 ocai host : 1099 

java. nami ng . factory . uri . pkgs=org . jboss . nami ng :org . jnp. i nterf aces 

Tel quel, ce fichier suppose que le programme client sera lance depuis la meme 
machine que celle faisant tourner le serveur JBoss. Si vous possedez deux 
machines, n'hesitez pas a modifier ce fichier en changeant la ligne 
java. naming. provider. url, de maniere a remplacer la valeur "localhost par 
l'adresse IP ou le nom DNS de la machine serveur. 

Conclusion partielle - travail necessaire au codage d'un EJB a la 
main... 

Le travail necessaire au codage a la main d'un EJB est done tres important. Ima- 
ginons un moyen de nous concentrer sur la partie interessante et d'oublier toute 
la « tuyauterie » necessaire. 

Etant donne la redondance d'informations entre, d'une part, les interfaces et 
classes abstraites et, d'autre part, les classes d'implementation creees a partir des 



112 



consignes de deploiement par le conteneur, on pourrait imaginer faire generer 
pour nous par un outil tiers ce code peu interessant et propice aux erreurs. Une 
telle approche permet resolument de raccourcir le cycle de developpement, 
d'ameliorer la qualite du code (une fois un outil valide, on peut etre sur de ce 
qu'il produit) et de nous concentrer sur la logique applicative, qui est le plus 
interessant pour une entreprise. 

Comment ? Quelle technique utiliser ? La reponse est simple : les doclets Java. 



Introduction aux doclets 

Les doclets introduites avec le JDK 1.2 permettent de modifier l'apparence de la 
documentation creee via javadoc, ou du moins s'agit-il la de leur utilisation pre- 
miere. Cependant, avec un peu d'imagination, on voit que Ton dispose d'un 
outil assurant le parsing d'un source Java (et le faisant vite et bien), ainsi que 
d'une API robuste. C'est plus que suffisant pour detourner l'outil de sa destina- 
tion originelle et imaginer faire de notre fichier Java une source de donnees 
moins reduite que la simple somme des codes des differents services. En ajou- 
tant quelques balises (@monsignet blah blah) qui n'ont de sens que pour nous, 
on peut imaginer beaucoup d'autres utilisations a cette technique, par exemple : 

• production de documentation ; 

• ecriture de code ; 

• modification du code initial (instrumentation). 
Citons quelques produits utilisant cette mecanique : 

• iDoclet : outil d'instrumentation de code permettant d'ajouter a Java la ges- 
tion des assertions au sens de la programmation par contrats ; 

• XDoclet : nous reviendrons bientot sur cet outil. . . ; 

• DocBookDoclet : pour imprimer au format DocBook vos API ; 

• Bouvard& Pecuchet : un ensemble de deux outils visant a ameliorer la qua- 
lite du code. 

Manipuler les doclets 

Avant d'utiliser un produit, comprendre les tenants et aboutissants semble 
naturel. Pour cela, rien de tel qu'une petite mise en pratique du sujet. BlueWeb 
decide done de realiser un petit exemple tres simple mettant en ceuvre un doclet 
« maison » avec une balise personnalisee (blueweb, de maniere tres originale). Ce 
programme peu ambitieux n'est destine qu'a mieux percevoir comment fonc- 
tionnent des outils complexes ; il ne s'agit nullement d'esperer un resultat utili- 
sable par la suite. 



B.A.-BA Doclets 

Avec le JDK 1 .2, Sun a introduit la possibility de per- 
sonnaliser tres simplement la documentation creee 
via javadoc : juste en codant une classe Java parti- 
culiere appelee doclet. L'idee centrale est de ne pas 
a avoir a redevelopper du code dedie au parsing du 
code Java et done de laisser javadoc le faire pour 
vous ! Ensuite, vous n'avez qu'a utiliser les metho- 
des de tres haut niveau mises a disposition par I'API 
javadoc (paquetage com. sun. javadoc) pour 
mettre en forme selon vos desirs. L'outil javadoc 
cree en standard une documentation HTML ratta- 
chee a chaque source Java via exploration de celui- 
ci et en reagissant face a certaines balises particulie- 
res (©author, @param, etc.), mais rien ne nous 
empeche de generer du code Java... Une tres bonne 
introduction sur ce domaine est disponible a I'URL 
suivante : 

► http://www.javaworld.com/javaworld/ 
jw-08-2000/jw-081 8-javadoc_p.html 



ALLER PLUS LOIN Pharos, le moteur de 
recherche dedie a Java 

► http://pharos.inria.fr/Java/ 

query.jsp?cids=c 221 0 
est I'URL permettant de lancer une recherche 
adaptee a ce domaine sur la base de donnees du 
site Pharos, superbe outil issu du travail de I'INRIA 
et de volontaires (Olivier Dedieu, Nicolas Delsaux, 
entre autres). 



POLEMIQUE Sur I'art de faire du jetable 

Ce sujet revient souvent sur la table au cours de 
projets. Trap souvent, des projets debutent sur 
des bases issues de produits jetables... II sem- 
ble bon de limiter I'utilisation de code jetable 
aux simples sujets necessitant un retour pour 
validation esthetique, approfondissement d'un 
point technique ou apprentissage sur un theme 
precis. Sinon, les risques de voir en production 
un code initialement destine a la poubelle sont 

P ' USqUepr0bableS - 
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Vbici done le code de ce doclet de test : 



Attention, ces classes etant des classes internes 
Sun, la portability de ce code n'est pas assuree 
sur toutes les machines virtuelles possibles. Pour 
compiler/executer ce code, il est necessaire 
d'avoir le tools, jar dans le classpath du pro- 
jet. 



Une fois la balise de debut reperee, on demande 
I'invocation de la methode dump(). 



Cette methode permet d'illustrer les differentes 
possibility offertes par I'API des doclets. On voit 
comment Ton peut obtenir des informations 
concernant une methode ou un attribut, les tags 
(balises) associes aux commentaires d'une 
methode... 



Classe d'illustration du concept de doclet avec 

package com. blueweb. test. doclet; 
import com. sun. javadoc.GassDoc; 
i mport com . sun . j avadoc . MethodDoc ; 
import com. sun. j avadoc. RootDoc; 
import com. sun. j avadoc. Tag; 

/** 

* ©author BlueWeb 

* <p> 

* Petite classe de test mettant en oeuvre les doclets Java. 

* Ici , nous allons manipuler un tag bien a nous (nous nous 

* contenterons d'afficher les commentaires inseres dans ce tag 

* mais on peut imaginer d'autres utilisations... 

* </p> 

*/ 

public class CustomTag { 

/** 

* <p> 

* la methode start() est appelee automatiquement par l'outil 

* javadoc. Pour executer notre classe, il faudra utiliser 

* une syntaxe de ce type : 

* javadoc -doclet com. blueweb. test. doclet. CustomTag 

* </p> 

V 

public static boolean start (RootDoc root){ 
dump(root.classes() , "blueweb") ; 
return true; 

} 



* 



<P> 



* affiche les tags associes a des commentaires de methode 

* pour une liste de classes passees en argument, le tag recherche 

* etant blueweb (passe en parametre tagName) 

* </P> 

* @param classes, liste des classes 

* @param tagName, nom du tag cible (blueweb) 

*/ 

private static void dump(ClassDoc[] classes, String tagName) { 

// itere sur la collection... 

for (int i=0; i < classes. length; i++) { 
// un drapeau utilise pour eviter de dupliquer 
// les affichages du nom de la classe 
boolean classNamePri nted = false; 

// extrait les infos sur les commentaires de methodes 

// pour la classe en cours 

MethodDoc[] methods = classes[i] . methods () ; 

// itere sur ce tableau 

for (int j=0; j < methods. length; j++) { 
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// pour une methode donnee, n'extrait que les 
// tags dont le nom est celui de notre cible 
Tag[] tags = methods [j] .tags (tagName) ; 
if (tags. length > 0) { 

if (IclassNamePrinted) { 

System. out. print~ln("\n" + classes[i] .name() + 
classNamePrinted = true; 

} 

System. out. print~ln(methods[j] .name()) ; 
for (int k=0; k < tags. length; k++) { 

System. out. println(" " + tags [k] . name() + 
+ tags[k] .textO) ; 

} 

} 

} 



00 



E 

-5 



} 



} 



Etant donne que nous utilisons un tag particulier, il est bon de tester avec un 
fichier source possedant des occurrences de ce tag. . . C'est precisement l'objet de 
la classe de test qui suit. 



package com. blueweb. test. doclet; 
public class TesClass { 

/** 

* ©blueweb oh un tag 

* ©blueweb deuxieme tag dans foo 

* ©autretag pas interessant celui la 

V 

public void foo(){ 
} 

/** 

* ©autretag ne doit pas apparaitre 

V 

private void bar(){ 
} 

/** 

* ©blueweb oho un autre tag sympa 

V 

protected int foobar(){ 
return -1; 

} 



Une classe bien inutile mais permettant de tester 
notre doclet... 



} 



Et voici le resultat de l'execution de ce code. On utilise comme paquetage cible 
com. blueweb. test. doclet, etant donne qu'il y a peu de chance de trouver 
ailleurs des traces de cette balise inutile, javadoc -help pour les options de 
javadoc. 
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> javadoc -doclet com. bl ueweb. test. doclet.CustomTag 
com . bl ueweb . test . docl et 

Loading source files for package com. blueweb. test. doclet. . . 

Constructing Javadoc information... 

TesClass 

foo 

@bl ueweb: oh un tag 
@bl ueweb: deuxieme tag dans foo 
foobar 

Obi ueweb: oho un autre tag sympa 

Pourquoi le tag documentant la methode bar() de la classe de test n'apparait-il 
pas lors de l'execution de ce doclet ? La reponse tient simplement dans la con- 
ception de javadoc, qui par defaut ne regarde pas les methodes privees (c'est tout 
a fait normal puisqu'un programmeur client n'a pas a s'embarrasser avec les 
details de notre implementation). 

Ce petit bout de code tres simple a permis a l'equipe BlueWeb de comprendre 
les rudiments de la technologie des doclets et d'acquerir le recul necessaire pour 
apprecier un tel outil. . . 



Outil rattache : XDoclet 



(SODoclet 

* J Altribule Oriented Programming 

Figure 5-6 Logo du projet XDoclet 



ALTERNATIVE EJBGen 



Pour les utilisateurs de Weblogic, il faut signaler 
I'excellent outil de Cedric Beust, maintenant inte- 
gre dans Weblogic Server (depuis la version 7) : 
EJBGen. II utilise aussi I'idee des doclets Java. Mal- 
heureusement, pour des raisons historiques, il 
n'est pas place sous licence Open Source. 
► http://beust.com/ejbgen 



Comme nous venons de le voir, le developpement d'un composant EJB peut 
reclamer jusqu'a sept classes et un fichier XML. De plus, la norme EJB 
s'appuyant sur de grosses conventions de nommage, ce travail s'avere vite fasti- 
dieux et done propice a de nombreuses petites erreurs dues a un manque 
d'attention ou a une utilisation excessive du copier/coller. II faut done chercher 
une solution logicielle a meme de nous macher le travail. C'est la qu'intervient 
XDoclet, un outil Open Source qui utilise le concept des doclets Java pour 
fournir a partir du seul code source reellement utile de la liste precedente : le 
bean d'implementation (CompteBean dans notre exemple) et les composants rat- 
taches, a savoir Home interface, Remote Interface, LocalHome et Local 
Interface, fichier de description du deploiement... 

XDoclet est disponible a l'URL suivante : http://xdoclet.sourceforge.net. La derniere 
version disponible est la 1.2.2, qui semble corriger de nombreux bogues de la 
precedente version de developpement. 

Introduction a XDoclet 

XDoclet se presente sous la forme d'une tache Ant et, comme tout doclet, parse 
un ensemble de fichiers source . java. 

Lidee centrale regissant l'utilisation de cet outil est que, lors du developpement 
d'un EJB, la seule classe d'implementation (MonEJBBean. java) enrichie de quel- 
ques informations doit permettre de guider le reste du deploiement de ce com- 
posant. II vous suffit done d'enrichir le fichier MonEJBBean. java des differents 
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tags introduits par XDoclet, puis de lancer XDoclet via Ant pour obtenir tous 
les fichiers necessaires au deploiement de votre composant au sein de votre ser- 
veur d'applications, c'est-a-dire : 

• la home interface associee (en local comme en remote suivant vos 
directives) ; 

• la remote interface associee (en local comme en remote suivant vos 
directives) ; 

• la description de deploiement (ejb-jar.xml) ; 

• les Vai ue Object (ou Data Object suivant la version de XDoclet utilisee) ; 

• les fichiers complementaires propres a votre serveur d'applications. 

Eh oui ! tout cela est obtenu a partir d'un seul et meme fichier et en plus avec 
l'independance par rapport au serveur d'applications puisque XDoclet gere spe- 
cifiquement les serveurs : 

• JBoss ; 

• Weblogic (Bea) ; 

• Jonas (objectweb) ; 

• Websphere (IBM) ; 

• Jrun (Macromedia) ; 

• Resin (caucho) ; 

• Pramati ; 

• Easerver (Sybase) ; 

• Hpas(HP); 

• Orion (Orion). 

De plus, cet outil propose aussi de guider la gestion du mapping objet/rela- 
tionnel si vous le confiez a une des technologies suivantes : 

• JDO (Java Data Objects, specification de Sun implementee par differents 
produits) ; 

• Hibernate ; 

• MVCSoft. 

Pour en finir avec la liste des technologies prises en compte par XDoclet, il faut 
preciser que ce produit s'interface tres bien avec Struts. 

De plus, de par son architecture et son design, XDoclet est un produit ouvert et 
evolutif, vous permettant via les merge points d'adapter la generation a votre con- 
texte et, en plus, d'etre etendu (vous pouvez baser votre doclet sur XDoclet). Et 
tout cela est propose sous une licence legale proche de la licence Apache. . . 
Meme si l'utilisation telle qu'illustree par le projet BlueWeb est typiquement 
tournee vers les EJB, ce produit ne se cantonne pas a ce domaine. Ainsi, on peut 
citer l'utilisation de XDoclet pour les classes manipulant JMX (creation de 
MBeans), le deploiement de servlets, etc. 

La solution avant de lancer une equipe dans un tel produit est peut-etre de qua- 
lifier l'adequation du produit avec vos besoins, de faire un test et dans le pire des 
cas de figer son choix sur une version, quitte a ne pas beneficier des nouvelles 
fonctionnalites introduites lors de versions ulterieures. 



POLEMIQUE XDoclet, la « silver bullet » 

Avec une presentation si elogieuse, vous pouvez 
voir en XDoclet la balle magique, solution a tous 
vos problemes. II s'agit reellement d'un tres bon 
outil, mais il est bon de preciser que la docu- 
mentation n'est pas toujours a la hauteur du 
produit, que la principale source d'aide (la liste 
de diffusion) est une des plus desagreables qui 
soit (gare aux newbies J) et que les codeurs de 
XDoclet n'ont aucun scrupule a changer tous les 
tags lors du passage de la version 1.1 a la 
version 1 .2 et rendent ainsi caduques vos codes 
source utilisant les anciens tags, ce qui est red- 
hibitoire dans la plupart des cas ! Attention, la 
liste est quand meme de tres bonne qualite 
puisqu'on y croise frequemment Erik Hatcher, 
auteur du meilleur ouvrage dedie a Ant, ainsi 
que David Jencks, auteur de la couche de ges- 
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Ajoutez des doclets dans vos build-files 

Et maintenant, place a Taction ! Examinons le build-file adapte d'exemples 
trouves sur Internet pour adapter XDoclet (principalement celui realise par 
David Jencks de Tequipe JBoss pour la compilation/deploiement des exemples 
accompagnant JBoss). Ce fichier est livre tel quel, mais les annotations tien- 
dront lieu de commentaires. . . 



Utilise un fichier properties (.ant. 
properties) situe dans le repertoire courant 
ou dans le repertoire personnel de I'utilisateur. 
Ce fichier evite de modifier le build-file a tout 
instant. 



Cette cible permet de s'assurer que JBoss est 
bien present en controlant la presence de la pro- 
priety jboss.home. Si cette derniere est 
absente, affiche le message defini dans fail. 
Remarquez I'utilisation de unl ess et f ai 1 . . . 



Cette cible complete la precedente en controlant 
une eventuelle mauvaise valeur pour la propriete 
jboss.home et ceci grace a une variable 
jboss. present. Si jboss. present est a 
f al se, le message d'erreur s'affiche. 



On controle la presence de XDoclet. 



Script Ant modele utilise 

<?xml version="1.0"?> 
<! — Template build file 
<project name="template" 



default="main" basedir=" 



Give user a chance to override without editing this file 
(and without typing -D each time they run it) 

--> 

<property file=". ant. properties" /> 

<property file="${user. home}/. ant. properties" /> 

<property name="Name" val ue="Template"/> 
<property name="version" value="l.l"/> 

<target name="check-jboss" unless="jboss.home"> 
<f ai 1 > 

Property "jboss.home" is not set. Please use the file 
".ant. properties" in this directory ${basedir} to 
set this property. It must point to the directory which 
contains the following directory: "deploy", "conf", "tmp" 
etc. 
</fail> 
</target> 

<target name="check-jboss" unless="jboss.home"> 
<f ai 1 > 

Property "jboss.home" is not set. Please use the file 
".ant. properties" in this directory ${basedir} to 
set this property. It must point to the directory which 
contains the following directory: "deploy", "conf", "tmp" 
etc. 
</fail> 
</target> 

<target name="wrong-jboss" unless="jboss.present"> 
<f ai 1 > 

Property "jboss.home" is set but it does not seem 
to point to the right directory. The file "run. jar" 
must be available at ${jboss.home}/bin. 
</fail> 
</target> 

<target name="check-xdoclet" unless="xdoclet.home"> 
<fail> 

Property "xdoclet.home" is not set. Please use the file 

".ant. properties" in this directory ${basedir} to 

set this property. It must point to the root directory of 
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Script Ant modele utilise dans les exemp 

XDoclet distribution. 

</fail> 
</target> 

<target name="wrong-xdoclet" unless="xdoclet.present"> 
<f ai 1 > 

Property "xdoclet.home" is set but it does not seem 
to point to the right directory. The file "xdoclet. jar" 
must be available at ${xdoclet.home}/lib. 
</fail> 
</target 

<target name="check-envi ronment"> 

<antcall target="check-jboss"/> 

<avai 1 abl e property^" j boss .present" 

f i 1 e="${ j boss . home}/bi n/run . jar"/> 

<antcal 1 target="wrong-jboss"/> 

<antcal 1 target="check-xdocl et"/> 

<avai 1 abl e property="xdocl et .present" 

f i 1 e="${xdocl et . home}/l i b/xdocl et . jar"/> 

<antcal 1 target="wrong-xdocl et"/> 
</target> 

<target name="init" depends="check-envi ronment"> 

<echo message="bui Id. compiler = ${build.compiler}"/> 
<echo message="user.home = ${user. home}"/> 
<echo message="java.home = ${java. home}"/> 
<echo message="ant.home = ${ant. home}"/> 
<echo message="jboss.home = ${jboss . home}"/> 
<echo message="xdoclet.home = ${xdoclet.home}"/> 
<echo message="java. class . path = ${java. class. path}"/> 
<echo message=""/> 

<available property="jdkl. 3+" classname="java.lang.StrictMath" /> 
</target> 

<property name="j boss. lib" value="${jboss.home}/lib" /> 
<property name="jboss. client" value="${jboss.home}/client" /> 
<!-- Configuration used on IBoss 3 to run your server. There must 
be a directory with the same name under "${jboss.home}/server" 

--> 

<property name="jboss. configuration" value="default" /> 
<property name="j boss. deploy" 

value="${j boss. home}/server/${j boss. configu rati on}/deploy" /> 
<property name="src.di r" value="${basedi r}/src"/> 
<property name="src.main.dir" value="${src.di r}/main"/> 
<property name="src. client .di r" val ue="${s remain .di r}/client"/> 
<property name="src.ejb.di r" value="${src.main.dir}/ejb"/> 
<property name="src.servlet.di r" value="${src.main.di r}/servlet"/> 
<property name="src. resources .di r" value="${src.di r}/resources"/> 
<property name="src.web.di r" value="${src.di r}/web"/> 
<property name="src.etc.di r" value="${src.di r}/etc"/> 
<property name="lib.di r" value="${basedir}/lib"/> 
<property name="build.di r" value="${basedi r}/build"/> 
<property name="bui 1 d . tmp. di r" val ue="${bui Id .di r}/tmp"/> 
<property name="bui 1 d . depl oy . di r" val ue="${bui 1 d . di r}/depl oy"/> 



XDoclet est-il correctement defini ? 



Cette cible regroupe tous les tests necessaires au 
controle de I'environnement de travail. On peut 
remarquer que cette cible utilise des antcall 
pour executer des cibles (check- j boss, 
check-sxdoclet). 

Cette cible verifie les proprietes xdoclet. 
present et jboss . present en s'assurant de 
la disponibilite de certains fichiers grace a la 
tache available. 

Realise les initialisations. Utilise aussi la task 
avai 1 abl e pour positionner un drapeau per- 
mettant de savoir si la version de JDK est supe- 
rieure a 1 .3 ou non via la presence (absence) 
d'une classe (java . 1 ang . Stri ctMath). Initia- 
lise des variables a partir des proprietes genera- 
les definies dans le fichier .ant. properties 
de maniere a simplifier I'ecriture du build-file (la 
rendre plus legere). Dependance envers la cible 
check-envi ronment, ce qui veut dire que si la 
configuration n'est pas bonne, cette cible ne sera 
jamais atteinte... 
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Construit le cl asspath necessaire au lance- 
ment de XDoclet via la directive pathel ement. 



Construit le cl asspath dit de base. 



Lance la creation des EJB via XDoclet. Utilise 
pour cela une des deux tasks de XDoclet: 
e j bdocl et. On voit ici une illustration de I'utili- 
sation de taskdef, ou comment ajouter des 
tasks optionnelles ou inconnues lors de I'exe- 
cution d'un build Ant. Dependance envers la 
cible init. 



C'est ici que se fait I'appel a ej bdocl et, avec 
tous les parametres necessaires (version des 
specifications EJB, repertoire de destination). Les 
fichiers cibles seront tous les fichiers presents 
dans le repertoire pointe par la variable 
src.ejb.dir et finissant par Bean.java, 
done toutes les classes abstraites d'implementa- 
tion. 



Script Ant modele utilise dans les exemples JBoss (suite) 

<property name="bui 1 d . generate . di r" val ue="${bui 1 d . di r}/generate"/> 

<property name="bui Id. classes .di r" value="${build .di r}/cl asses "/> 

<property name="build.war.di r" value="${build.dir}/war"/> 

<property name="bui 1 d . cl i ent . di r" val ue="${bui 1 d . di r}/cl i ent"/> 

<property name="build.bin.di r" value="${build.di r}/bin"/> 

<property name="bui 1 d . javadocs . di r" val ue="${bui 1 d . di r}/docs/api "/> 

<path id="xdoclet.path"> 

<pathelement location="${ant.home}/lib/ant. jar" /> 
!-- AS Maybe necessary for Ant 1.5 and XDoclet 1.3 

<pathelement location="${ant.home}/lib/xmlParserAPIs. jar" /> 
<pathelement location="${ant.home}/lib/xercesImpl . jar" /> 
<pathelement location="${ant.home}/lib/bcel . jar" /> 
<pathelement location="${xdoclet.home}/lib/xjavadoc. jar" /> 

-> 

<pathelement location="${xdoclet.home}/lib/xdoclet. jar" /> 
<pathelement location="${jboss.client}/log4j . jar" /> 
</path> 

<path id="base . path"> 

<path refid="xdoclet.path"/> 

<pathelement location="${jboss.client}/jboss-j2ee. jar" /> 
<pathelement location="${jboss.client}/jnp-client. jar" /> 
<pathel ement 1 ocation="${j boss. client}/jbossmq-cli ent. jar 
<pathel ement 1 ocation="${j boss. client}/jbosssx-cli ent. jar 
<pathelement location="${jboss.client}/concurrent. jar" /> 
<pathelement location="${jboss.client}/jaas. jar" /> 
<pathelement location="${jboss.lib}/jboss-jmx. jar" /> 
<pathel ement location="${jboss.home}/server/ 

${jboss.configuration}/lib/jbosssx. jar" /> 
<pathel ement location="${jboss . home}/server/ 

${jboss.configuration}/lib/mail . jar" /> 
<pathelement location="${build. classes. dir}" /> 
</path> 



/> 
/> 



<!-- Generates the necessary EJB classes and deployment descriptors --> 
<!— ==========™=™=™=™= — > 

<target name="xdoclet-generate" depends="init"> 
<taskdef 

name="ejbdoclet" 

cl assname="xdocl et . e j b . E j bDocl etTask" 

> 

<cl asspath ref id="xdocl et . path"/> 
</taskdef> 

<ejbdoclet 

sourcepath="${src . ejb . di r}" 

destdi r="${buil d . generate . di r}" 

cl asspathref ="base . path" 

exel udedtags="@version , ©author" 

ejbspec="${ejb. version}" 

mergedi r="${src . resources . di r}/xdocl et" 

f orce="$ {xdocl et . force} " 
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<fileset dir="${src.ejb.dir}"> 



<i ncl ude name=" * */*Bean . java"/> 
</fileset> 

<packageSubsti tuti on packages="sessi on , enti ty" 

substi tuteWi th="i nterf aces"/> 
<dataobject/> 
<remoteinterface/> 
<homeinterface/> 
<entitypk/> 
<entitybmp/> 
<entitycmp/> 

<deploymentdescriptor destdi r="${build .di r}/META-INF"/> 
<!-- AS 4/29/02 Do not validate XML files because JBoss 3.0 

message driven will report an wrong error because 

it uses the wrong jboss.dtd --> 

<jboss version="${j boss. version}" 
xmlencoding="UTF-8" 
typemappi ng="$ {type . mappi ng} " 
datasource="${datasource. name}" 
destdi r="${bui 1 d . di r}/META-INF" 
val i dateXml =" f al se" 

/> 

</ejbdoclet> 
</target> 

< j __ ===================================== __> 

<!-- Compiles the source code --> 
<! — =====================================--> 

<target name="compile" depends="xdoclet-generate"> 
<mkdi r di r="${build.cl asses. dir}"/> 
<javac 

destdi r="${build.cl asses. di r}" 

debug="on" 

deprecation="off " 

optimize="on" 

cl asspathref ="base . path" 

> 

<src path="${src.ejb.di r}"/> 

<src path="${bui Id. gene rate. di r}"/> 
</javac> 
<javac 

srcdi r="${src. client. di r}" 
destdi r="${build.cl asses. dir}" 
debug="on" 
deprecation="off " 
optimize="on" 
includes^"**/*. java" 
classpathref="base. path" 

> 

</javac> 
</target> 



< Ce sont les options de generation, telles que 
demander la generation des remote 
interfaces, des home interfaces, des 
entites, du ejb-jar.xml, etc. 



< lei sont regroupees les informations propres a 
JBoss, telles que le nom de la source de donnees 
utilisee, la version, etc. 



< Compile le code source (celui fourni + celui pro- 
duit par XDoclet) en precisant la volonte d'obte- 
nir un code optimise. 
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Script Ant modele utilise dans les exemples JBoss (suite 



Commence I'empaquetage en archivant en un 
jar tous les EJB. Evidemment, cette tache 
requiert I'execution au prealable de la compila- 
tion des sources (d'ou la dependance envers 
compile). 



Compile le code des servlets. 



<!-- Creates the jar archives 



<target name="jar" depends="compile"> 
<mkdi r di r="${build.deploy.di r}"/> 
<mkdi r di r="${build.client.di r}"/> 
<mkdi r di r="${bui 1d.bin.di r} "/> 
<jar 

jarf i 1 e="${bui 1 d . depl oy . di r}/e jb-test .jar" 

> 

<fileset 

di r="${build.cl asses. di r}" 
i ncl udes="test/enti ty/** , test/sessi on/** , 
test/message/**, test/interfaces/ 

> 

</fileset> 
<fileset 

dir="${build.dir}" 

i ncl udes="META-INF/**" 

> 

</fileset> 
</jar> 
<jar 

jarfile="${build.client.dir}/client-test. jar" 

> 

<fileset 

di r="${build.cl asses. di r}" 

i ncl udes="test/i nterf aces/** , test/cl i ent/* 

> 

</fileset> 
</jar> 
</target> 

<!__ =========================================== — > 

<!-- Compiles the WEB source code --> 
<! ===========================================—> 

<target name="compile-web" depends="compile" 
if="servlet-lib.path"> 
<mkdi r di r="${build .war .di r}"/> 
<path id="web.path"> 

<path refid="base.path"/> 

<pathelement location="${servlet-lib.path}"/> 
</path> 
<javac 

destdi r="${build.war.di r}" 

debug="on" 

deprecation="off" 

optimize="on" 

cl asspath ref ="web . path" 

> 

<src path="${src. servlet.di r}"/> 
</ j avao 
</target> 
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Script Ant modele utilise dans les exemples JBoss (suite) 



-> 



<!-- Creates the war archives --> 
< ! — =============================================—> 

<target name="war" depends="compile-web" if="servlet-lib.path"> < I Code Web (servlets) en un fichier .war. 

<mkdi r di r="${bui Id .deploy .di r}"/> 
<copy todi r="${build.war.di r}/WEB-INF"> 
<f i 1 eset di r="${src . etc . di r}/WEB-INF" 
i ncl udes="j boss-web . xml "/> 

</copy> 
<war 

warfile="${build.deploy.di r}/web-client.war" 
webxml ="${src . etc . di r}/WEB-INF/web-cl i ent . xml " 

> 

<fileset di r="${src.web.di r}"/> 
<fileset di r="${build.war.di r}"/> 
<cl asses di r="${build.cl asses. di r}" 

i ncl udes="test/i nterf aces/**"/> 

</war> 
</target> 

<target name="deploy-server" depends="jar,war"> 
<copy todi r="${jboss.deploy}"> 

<fileset di r="${build. deploy. di r}" 

i ncl udes="* . jar , * .war , * . ear"> 
</fileset> 
</copy> 
</target> 



< I -- ======================================================== --> 

<!-- Creates the client binary --> 
< ! -- ======================================================== — > 

<target name="create-client" depends="jar"> 
<!-- Convert the given paths to Windows --> 

<pathconvert targetos="windows" property="jboss. home. on. windows" > 
<path> 

<pathelement location="${jboss.home}" /> 
</path> 
</pathconvert> 

<pathconvert targetos="windows" property="java. home. on. windows" > 
<path> 

<pathelement location="${java. home}" /> 
</path> 
</pathconvert> 

<!-- Convert the given paths to Unix --> 

<pathconvert targetos="unix" property="jboss.home.on.unix" > 
<path> 

<pathelement location="${jboss.home}" /> 
</path> 
</pathconvert> 

<pathconvert targetos="unix" property="java.home.on.unix" > 
<path> 

<pathelement location="${java. home}" /> 
</path> 
</pathconvert> 



C'est ici que Ton cree vraiment la distribution 
cliente. 
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La cible main, appelee par defaut, elle se con- 
tente par ses dependances d'invoquer les cibles 
deploy-server et create-client. 



Ici se deroule le grand menage : clean fait en 
sorte de remettre les choses a leur etat initial en 
supprimant tout ce qui a ete construit. 



En passant... 

Ce long fichier n'a pas pour seule vocation de 
remplir des pages : il permet d'apprehender la 
puissance de Ant et des outils compagnons (tels 
que XDoclet). II illustre parfaitement I'utilite de 
cet outil, qui permet de faire assez simplement 
des foules de choses utiles. 



Ant modele utilise dans les exemples JBoss (suite) 

<echo message="JBoss Home on Unix: ${jboss.home.on.unix}"/> 
<echo message="Java Home on Unix: ${java.home.on.unix}"/> 
<f i 1 ter token=" j boss . home" val ue="${ j boss . home . on . wi ndows}"/> 
<filter token="java. home" value="${java.home.on.windows}"/> 
<copy todir="${build.bin.dir}" filtering="yes"> 

<f i 1 eset di r="${src . etc . di r}/bi n" i ncl udes=" run-*cl i ent . bat"> 

</fileset> 
</copy> 

<copy file="${src.etc.di r}/bin/lcp.bat" 

todi r="${bui Id. bin .di r}"/> 
<filter token="jboss.home" value="${jboss.home.on.unix}"/> 
<filter token="java.home" value="${java.home.on.unix}"/> 
<copy todi r="${build. bin. di r}" filtering="yes"> 

<fileset di r="${src.etc.di r}/bin" includes="run-*client.sh"> 

</fileset> 
</copy> 

<copy file="${src.etc.di r}/jndi .properties" 
todi r="${build.bin.dir}"/> 

</target> 

<target name="main" depends="deploy-server,create-client"> 
</target> 

<target name="clean" depends="init"> 

<delete di r="${bui ld.di r}"/> 
</target> 
</project> 

Voila le code integral dun make f i 1 e realiste integrant XDoclet mais aussi assu- 
rant la creation des archives apres compilation et le deploiement sur le serveur 
d'applications. Ce deploiement est reduit dans ce cas a peu de choses puisque 
JBoss dispose d'un composant dedie a cette tache se basant sur la date de der- 
niere modification: en recopiant votre archive (.ear, .jar ou .war) dans le 
repertoire de deploiement, vous allez mettre a disposition du code plus recent 
qui sera immediatement charge et deploye. Attention done, sous d'autres ser- 
veurs d'applications cette tache peut etre plus ardue. 



Familiarisons-nous avec XDoclet 

Les sources de I'etude de cas sont livrees sur le site Avant de se plonger dans le code de Implication de gestion des signets, regar- 
d'accompagnement de I'ouvrage : dons un peu le code d'un exemple simple d'EJB (bean session sans etat) tel que 

► www.editions-eyrolles.com code avec XDoclet. Cet exemple est issu de la documentation XDoclet, il 

adopte les tags de la version 1.1.2 (l'ancienne version) mais permet de com- 

prendre la mecanique. 




package examples; 

import java. rmi .*; 

import javax.ejb.*; 

import org. w3c.dom. Document; 
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Exemple d'EJB code avec XDoclet 




import org.xbeans.DOMEvent; 
import org.xbeans.DOMSource; 
import org.xbeans.DOMListener; 
import org . xbeans . XbeansExcepti on ; 

* This is the EJB Receiver Xbean 

@ejb:bean type="Stateless" 

* name="org . xbeans . communication . ejb . receiver . Receiver" 

j ndi -name="org . xbeans . communi cation . e j b . receiver . Receiver" 

* display-name="EJB Receiver Xbean" * 

@ejb:env-entry name="channelBean" type="java.lang. String" 
value="your. channel .bean" 

*/ 

public class ReceiverBean implements SessionBean, DOMSource { 

// EJB Methods 

private SessionContext sessionContext; 

public void ejbCreateO throws CreateException { } 

public void ejbRemove() { } 

public void ejbActi vate() { } 

public void ejbPassivateO { } 

public void setSessionContext(SessionContext sessionContext) { 
this. sessionContext = sessionContext; 

} 

// DomListener method 

/** 

* The method that the sender uses to pass the Document over 

* @param Document incomingDocument 

* ©throws RemoteException 

* ©throws XbeansExcepti on 

* @ejb:interface-method view-type="remote" 

V 

public void documentReady(Document incomingDocument) 
throws RemoteException, XbeansExcepti on { 
if (DOMListener == null) { 
try { 

if (channelBean == null) { 

String cBean = (String) new javax. naming. InitialContext() . 

lookup("java:comp/env/channelBean") ; 

if (cBean == null) { 

throw new ExceptionO; 
} else { 

this.setChannelBean( cBean ); 

} 

} 

} catch (Exception e) { 

throw new XbeansExcepti on (i ncomi ngDocument. getNodeName () , 
"ejb receiver", "next component not established", 
"The component needs to be configured."); 

} 



< Ce tag est le plus interessant de tous ; il precise 
que Ton a affaire a un bean de type stateless 
(sans etat), donne son nom, son nom JNDI. 



< Notons cet autre tag XDoclet pour definir des 
valeurs d'environnement. II permet de ne pas 
coder en dur le canal ecoute par notre « listener 
DOM ». 

< Cette methode comme d'habitude doit imple- 
menter de maniere triviale les methodes en 
liaison avec le cycle de vie de I'objet dans le con- 
teneur. 



< II s'agit ici du code d'implementation, les servi- 
ces fournis par le bean. Ici, c'est un composant 
ecoutant des evenements DOM (une des metho- 
des de parsing de documents XML). 
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Exemple d'EJB < 

try { 

thi s . setDOMLi stener ( (DOMLi stener) 

Class.forName( channelBean ) . newlnstance() ); 
} catch (Exception e) { 

throw new XbeansException(incomingDocument.getNodeName() , 
"ejb receiver", "could not create the channel Bean: " + 
channel Bean + " " + e, 

"The component needs to be configured correctly 
(channel Bean)."); 

} 

} 

DOMLi stener. documentReady (new DOMEvent(this, incomingDocument)) ; 

} 

// DomSource methods 

private DOMListener DOMListener; 

/** 

* Set the DOMListener (usually worked out from the channelBean 

* property) 

* @param newDomLi stener 

V 

public void setDOMLi stener(DOMLi stener newDomLi stener) { 
DOMListener = newDomLi stener; 

} 

* Retrieve the DOMListener 

* ©return DOMListener 

V 

public DOMListener getDOMListener() { 
return DOMListener; 

} 

// Channel Bean: This is configured in the <env-entry> 
// in the ejb-jar.xml deployment descriptor 

private String channelBean; 

/** 

* Set the channel bean to keep the chain going 

* @param newChannel Bean 

V 

public void setChannelBean(String newChannel Bean) { 
channelBean = newChannel Bean ; 

} 

/** 

* Retrieve the channel bean name 

* ©return String 

V 

public String getChannel Bean() { 
return channelBean; 

} 
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Voila, ce qu'il faut retenir est comment, avec quelques balises, on economise une 
masse de travail assez importante. Ceci doit interesser tout developpeur, qui doit 
etre enclin a la paresse. 

Tirez la quintessence de XDoclet 

Cette section n'a pas la pretention d'etre un manuel de reference sur les EJB, elle vise juste a 
introduire une notion fondamentale (les doclets), ainsi qu'un outil de choix : XDoclet. II faut bien 
retenir que ce produit vous permet de vous concentrer sur I'essentiel (implementation de la logi- 
que metier (pour des beans session) et definition de vos attributs persistants (pour des entites). 
Avec un seul fichier source Java, enrichi de marqueurs conformes a la version de XDoclet que 
vous utilisez, vous laissez la charge au produit de produire I'arsenal de code et fichiers de 
deploiement rattaches a ce fichier. Cette demarche a le merite de vous liberer d'erreurs liees a 
une utilisation massive du copier/coller, qui est la seule alternative raisonnable. Avec un tel outil 
dans votre besace, vous etes surs de raccourcir les temps de developpement et de mieux mattri- 
ser les phases de migration d'un serveur d'application a un autre. La encore, c'est adopter une 
attitude pragmatique que de confier ces taches ingrates a un outil. 



Integrer XDoclet dans votre cycle de 
developpement 

Si XDoclet est un outil dont le caractere indispensable vient d'etre prouve, il 
nous reste encore a trouver une maniere elegante de l'integrer dans notre con- 
ception. Pour cela, reposons le contexte d'un environnement classique : 

• AGL supportant UML ; 

• IDE ou editeur de texte ; 

• fichiers .java. 

L'utilisation de XDoclet telle que presentee precedemment pose probleme, dans 
le sens ou les tags necessaires a son execution sont consignes uniquement dans le 
code des fichiers d'implementation de nos beans. Cela constitue une faiblesse 
indeniable et denote un manque de continuite dans le cycle si Ton adopte une 
approche type MDA. En substance, ce type d'approche vise a voir dans le 
modele UML la seule source d'informations importante, puisque le modele va 
etre utilise comme referentiel servant a l'elaboration d'une grande partie du 
code. 

Vers une amorce de solution 

Imaginons l'approche ideale. Elle necessiterait les etapes suivantes : 

1 creation du modele UML ; 

2 enrichissement du modele avec des informations guidant le deploiement ; 

3 export de ce modele ; 

4 lancement de Ant et production des fichiers. 



BA AGL 



L'atelier genie logiciel designe des outils capables 
de prendre en charge une large partie (si ce n'est 
I'integralite) du cycle de developpement (analyse, 
conception, codage, test, production de documen- 
tation). On peut citer ArgoUML, Objecteering, 
Rational XDE et bien d'autres. 



B.A.-BA MDA (Model Driven Architecture) 

L'approche MDA tente de regrouper toute I'intelli- 
gence au sein du modele, de maniere a y trouver 
un referentiel unique de documentation et a pou- 
voir utiliser des outils de production de code 
depuis le modele. 
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B.A.-BA OMG (Object Management Group) 

Organisme en charge de la standardisation et de 
1'evolution d'UML. 



Vbila une approche seduisante. Cependant, parmi ces quatre etapes, la troisieme 
semble problematique : comment exporter un modele UML independamment 
de l'outil utilise ? La reponse est simple car l'OMG gerant UML a anticipe ce 
type d'utilisations : la solution se nomme XML Avec cette arme entre nos 
mains, on peut imaginer un outil permettant de lire du XMI et de creer les 
fichiers necessaires au deploiement en s'appuyant sur XDoclet. 



B.A.-BA XMI 



Format neutre de donnees s'appuyant sur du XML 
pour vehiculer le contenu de modeles UML afin de 
faciliter les communications entre outils. 



Figure 5-7 

Integration de XDoclet dans 
le cycle de developpement 



Integration de Xdoclet dans le cycle de developpement 



Modele UML 



Export XMI 



Outil de 
generation 



.java et .xml 



AndroMDA : le candidat ideal 

II faut constater qu'etant donne les choix restrictifs imposes par notre recherche, 
► http://uml2ejb.sourceforge.net/ il n'y a pas beaucoup de candidats possibles. A vrai dire, il n'y en aurait meme 

qu'un seul : AndroMDA (anciennement UML2EJB). Ce projet Open Source 
possede done toutes les vertus desirees. Vous le trouverez a l'adresse ci-contre. 
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Integration de I'outil 

Examinons comment mettre en ceuvre pratiquement cet outil par l'interme- 
diaire d'un extrait de build-file Ant. 

Extrait de script Ant invoquant AndroMDA (UML2EJB) 



<unzip src="Modele.zargo" dest="${build.di r}/unzipped" /> 

<style basedi r="${build .di r}/unzipped" 
destdi r="${bui 1 d . di r}/model " 
extension=" .xml " 
includes="*.xmi" 

style="${env.UML2EJBH0ME}/xrrn'-to-simple00.xsT' 

/> 

<uml2ejb basedi r="${build.di r}/model " 

ejbDestdi r="${generated.src.di r}" 

imp! Destdi r="${handcrafted . src. di r}" 

includes="*.xml" 

1 astModi f i edCheck="true" 

tempi atePath="${env.UML2E]BH0ME}" 

useDef aul tTempl ateConf i g="t rue" 

/> 

Dans cet extrait de code (portion de fichier bui 1 d . xml ), on suppose recuperer un 
modele UML provenant de I'outil ArgoUML (outil Open Source). Le fichier 
model e.zargo est un fichier compresse ; on le decompresse done avec la tache 
unzip. Puis, a l'aide de la tache style (voir chapitre 7 pour plus d'informations 
et exemples d'utilisation de cette tache), on transforme le fichier XMI par 
XSLT. Enfin, on utilise la tache uml2ejb pour lancer la creation de nos EJB. 

Meme si cet outil est encore jeune, il nous propose une solution elegante et 
puissante permettant de gagner en productivite tout en ayant un referentiel 
d'informations complet (modele UML). II est done interessant de jeter un ceil a 
cet outil en devenir. 



Decompression du fichier modele UML. 



Transformation en un document XMI. 



Appel de la task um!2ejb. 



B.A.-BA XSLT (Extensible Stylesheet 
Language Transformations) 

Transformation d'un format de fichier en un autre 
format, guidee par XML. 



En resume... 

Ce chapitre ne peut etre une presentation exhaustive des EJB, mais il en a rappele 
les principes fondamentaux avant de s'attarder sur comment developper intelli- 
gemment des EJB en faisant faire a un outil le gros du travail rebarbatif. De plus, 
nous avons saisi l'occasion de presenter un « vrai » buid-file, pret a l'emploi, pou- 
vant vous macher le travail lors de futurs developpements J2EE. Bref, ce chapitre 
pretend presenter des solutions pragmatiques a meme de faciliter et d'accelerer les 
developpements en environnement J2EE. En proposant par le biais de 
AndroMDA (UML2EJB) une solution vous permettant d'integrer les informa- 
tions de deploiement dans votre modele UML, on peut penser que vous disposez 
de toutes les briques permettant d'effectuer un travail efficace. 



Deploiement et gestion des versions 
avec Ant et Java Web Start 



Une fois l'application cliente prete, il faut la diffuser aux 
utilisateurs. Dans notre cas, la diffusion se limite aux employes 
de BlueWeb via le reseau interne de la societe. Quelle politique 
adopter et avec quels outils ? Nous verrons comment utiliser 
Java Web Start pour deployer notre application sur le reseau 
intranet de BlueWeb. 



SOMMAIRE 

► Gestion des versions d'une 
application 

► Signature electronique de 
fichiers avec Ant 

► Utilisation de Java Web Start 

► design pattern Factory et 
Singleton 
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Pourquoi developper une application si son deploiement est si complexe/cou- 
teux que personne ne peut l'utiliser ? Comment reduire ces couts ? 



PRATIQUE Cout d'administration 
d'une application 

Tous les managers et directeurs de service doivent 
etre vigilants sur cet indicateur. II s'agit pour eux 
de limiter les interventions de techniciens sur les 
postes clients pour de simples mises a jour ou ils 
se contentent d'inserer un CD-Rom et de cliquer 
sur des boutons. L' experience acquise au cours des 
annees 1990, ou le nombre d'applications de type 
deux couches (Delphi ou VB par exemple) a 
explose, leur a permis de comprendre qu'ils ne 
pouvaient plus se permettre de mobiliser des res- 
sources humaines pour des operations aussi trivia- 
les qu'inserer un CD-Rom et cliquer sur des bou- 
tons. De plus, lorsque I'entreprise est repartie sur 
plusieurs sites, les couts et delais de mise a jour de 
tels applicatifs croit exponentiellement. 



POLEMIQUE [.'experience des 
technologies proprietaires 

En plus des problemes de perennite de telles 
solutions, se pose pour les decideurs le probleme 
des couts de maintenance des postes clients. En 
effet, la plupart des machines de grandes socie- 
tes sont configurees par installation d'une 
image, d'un clone d'une installation validee par 
I'entreprise. L'utilisation de technologies stan- 
dards permet done de s'assurer de I'adequation 
de ces postes clients avec I'applicatif. Car il faut 
bien comprendre que redeployer 20 000 postes 
ne se fait pas en un jour... Pour un poste 
bureautique typique, on peut imaginer une 
image (type ghost de Symantec) comprenant : 
un systeme (disons Windows 2000), une suite 
bureautique (Works, Office ou OpenOffice.org), 
un navigateur (Mozilla Firefox ou IE). 



Gerer les versions et maintenir 
Implication 

Pour BlueWeb, les questions de gestion et de maintenance sont cruciales. 
L'experience a en effet montre qu'il n'est pas envisageable de faire face au pro- 
bleme des appels recurrents a l'assistance technique pour des bogues connus, 
repertories et corriges. La politique de deploiement, simple, efficace et realiste 
qui reponde a ces exigences est la suivante : 

1 Automatiser la mise a jour du produit des qu'une nouvelle version est publiee 
(sans intervention manuelle). 

2 Supprimer toute intervention sur le poste client qui se limiterait a l'insertion 
d'un CD-Rom contenant la nouvelle version. 

3 N'utiliser que des technologies s'appuyant sur des standards pour eviter des 
configurations trop exotiques sur le poste client (eviter d'installer des proto- 
coles reseau trop proprietaires en se contentant des classiques TCP/IP, FTP 
et HTTP par exemple). 

L'equipe BlueWeb a remarque l'emergence d'une technologie chez Sun : Java 
Web Start, dont le fonctionnement pour le deploiement d'une application est 
simplifie (voir figure 6-1). 




Figure 6-1 Schema de principe de la technologie Java Web Start 



Un utilisateur telecharge depuis son PC l'application qui vient remplir le cache 
applicatif, il utilise l'application (via les icones de lancement JWS) jusqu'a ce 
qu'une nouvelle version soit disponible (il y a contact entre le PC client et le ser- 
veur pour savoir si une nouvelle version est disponible ou non), celle-ci est tele- 
chargee puis remplace la precedente version dans le cache, etc. 
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Le diagramme de sequence UML suivant schematise les interactions entre les 
acteurs intervenant lors du lancement d'une application deployee via Java Web Start. 



client: 



cache I WS: 



I anceAppli cation 



T 



serveur web: 



T 



nouvelleVersionDisponible ' 
— 1 



renvoi eN ouvel I eV ersi on 



«comment» 
met a jour le cache 



«description» 
dialogue client/serveur 
viaJNLP 



«comment» 
si pas de nouvelle 
version ne faitrien 



//, JNLP 



JNLP signifie Java Network Launching Protocol et 
designe le protocole developpe par Sun pour Java 
Web Start. 



REFERENCE Java Web Start 

L'URL http://java.sun.com/products/javawebstart/ 
est la page d'accueil Sun de Java Web Start, alors 
que la page de Gerald Bauer (http://vamphq.com/) 
est surement sur Internet la meilleure collection de 
ressources dediee a ce sujet. 



Figure 6-2 

Diagramme de sequences UML 
pour le dialogue client/serveur 



Les JRE recents (1.4.x) incluant Java Web Start, l'installation de ce produit 
dans de telles conditions est reduite a neant. Vbici une copie d'ecran de la 
fenetre principale de Java Web Start (voir figure 6-3), obtenue apres avoir clique 
sur l'icone Java Web Start. 



^Gettionnaire d'ap plications Java Web Start 



hcluei Application Allichage Alt*; 
Applications : Applications distantes 



j^li,Didw4 Apn kj 
Notepad App 




L :J MMaryGdme App 
I Swill||Scl2 App 



Molnsrtn details * 
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Notepad App 
halinqiie par : Sun Microsystems, Inc. 
Page d'accueil : htlp:',)atfa, siin.com ■products.)avawflhstart.dB.. 
Dosr.rlptlnn : Notepad Dame Short Description 

«*•© 



Figure 6-3 

Lancement d'applications 
avec Java Web Start 
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Un ecran propose d'installer des raccourcis sur le bureau (figure 6-4). 



Militdrylidine App - Integration 



52E 



Vous avez hteculs MililaiyOame App 
deur tois. vtfulez-wajs creerles 
raccourcis correspondants ? 

0 Raccourcisu Ik Inn can 

v| Rduuuui ui dans lu itMrmi Denial I «i 



Figure 6-4 Creation des raccourcis 



ATTENTION Configuration du serveur 

La manipulation suivante, realisee par I'adminis- 
trateur systeme pour configurer le serveur Apa- 
che utilise pour I'intranet de BlueWeb, n'est pas 
forcement adaptee a votre serveur (en particu- 
lier s'il s'agit d'un serveur IIS de Microsoft). 



ATTENTION Editer httpd.conf sous root 

II faut des privileges du type root pour configu- 
rer le fichier Apache httpd . conf sous Unix. 



Utilisation de Java Web Start sur le reseau 
BlueWeb 

Que faut il mettre en place au sein de BlueWeb pour pouvoir deployer l'applica- 
tion via Java Web Start ? 

En realite, il faut peu de choses : 

1 configurer le serveur web interne de maniere a ce qu'il gere l'extension . j nl p ; 

2 installer un JRE 1.4 sur les postes clients (ou 1.3 x + les binaires Java Web Start) ; 

3 creer le fichier . j nl p et la page HTML devant etre installes sur le serveur web ; 

4 et bien sur empaqueter l'application cliente de maniere a la distribuer via le reseau. 

Nous ne detaillerons pas ici comment installer un JRE sur une machine cliente, 
mais on peut noter au passage que cette procedure peut etre integree dans 
l'image d'une machine realisee avec un outil du type Symantec Ghost. Ce type 
de procede permet de proposer des machines identiques et de reduire les couts 
d'installation. Mais il faut gager que les DSI le savent deja... La machine vir- 
tuelle Java (JRE) s'installe par lancement de l'assistant d'installation sous Win- 
dows ou d'un paquetage ( . deb ou . rpm) sous Linux. 

Configuration du serveur web 

Dans le cas d'Apache (serveur web utilise chez BlueWeb), il suffit d'ajouter, 
dans le fichier .htaccess global de l'installation, les lignes suivantes : 

AddType application/x-java-jnlp-file . jnl p 
AddType application/x-java-archive-diff .jardiff 

Vous pouvez aussi inserer ces instructions dans le fichier de configuration gene- 
rale d'Apache httpd.conf. 
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Creation du fichier .jnlp 



N'importe quel editeur de textes convient pour cette tache. II suffit juste de 
comprendre les balises utilisees par Java Web Start pour commencer l'edition de 
ce fichier. 

Fichier de deploiement .jnlp 

<jnlp href="bookinarks . jnl p" codebase="http://i ntranet/bookmarks/jnlp"> 
<"informat"ion>Q 

<title>Cestion des Signets</title> 

<vendor>B~lueWeb dev team</vendor> 

<homepage href="http://intranet/bookmarks"/> 

<descn'ption>Une petite application de gestion de signets. </description> 

<icon href="img/signet.gif"/> 

offline-allowed /> 
</information> 
<security>© 

<all -permissions /> 
</security> 
<resources>@ 

<j2se version="1.4 1.2+" /> 

<jar href="lib/bookmarks. jar" /> 

<jar href="lib/oro. jar" /> 

<jar href="lib/httpclient. jar" /> 

<jar href="lib/castor. jar" /> 

<jar href="lib/log4j . jar" /> 

<jar href="lib/swt. jar" /> 

<jar href="iib/workbench. jar" /> 
</resources> 

<app1ication-desc main-ciass="com.blueweb. bookmarks. gui .MainGui" />© 
</jnlp> 

Un fichier .jnlp est divise en quatre sections : 

O section information : pour des informations tres generales telles que le nom 

de l'application, l'auteur, etc. ; 
Q section security : pour la gestion des droits de l'applicatif par rapport au 

poste client (jusqu'a maintenant, seule la valeur indiquee etait possible, mais 

ceci devrait changer dans le futur) ; 
0 section resources : pour la description des ressources requises par cette 

application, qui doivent etre empaquetees en fichiers jar signes 

numeriquement ; 

O puis la description de l'application comprenant la classe principale a execu- 
ter, ainsi que les eventuels parametres passes a celle-ci (comme en ligne de 
commandes). 

Ce fichier utilise des URL comportant le nom de la machine serveur sur 
laquelle l'application est deployee (pour le telechargement). Dans le cas de 
BlueWeb, cette machine est la machine referencee sous le nom d'lntranet par 
les serveurs DNS internes. 



RAPPEL 

SWT utilise une bibliotheque native. 



PRATIQUE Gerer I'heterogeneite d'un pare 

Le pare de machines clientes a ete precise 
comme etant uniquement constitue de machines 
Windows, ce qui est un cas extremement simple, 
voire simpliste. Souvent I'heterogeneite prime et 
Ton peut trouver pele-mele des Mac, des PC, des 
stations de travail. . . SWT, quoique dependant de 
bibliotheques natives, reste portable sur differen- 
tes plates-formes ; la distribution de notre appli- 
cation dans un tel contexte necessiterait juste un 
raffinement de la page HTML permettant d'acce- 
der au fichier . jnlp deploye sur notre serveur, 
en y ajoutant par exemple un script JavaScript 
permettant d'aiguiller vers differents fichiers 
.jnlp correspondant aux differentes architectu- 
res materielles. 



B.A.-BA Signature 
de documents electroniques 

La signature electronique de documents utilise un 
algorithme asymetrique. Ce type d'algorithmes 
repose sur deux des. La premiere, dite cle privee, 
doit rester secrete et permet de signer le 
document ; la seconde, dite cle publique, permet- 
tra de le dechiffrer ou de verifier la signature. Cette 
derniere est publiee (done tout sauf confidentielle, 
d'ou son nom...). 



La section resources contient la liste des jar utilises par l'application (biblio- 
theques telles que ORO, SWT, etc.), ainsi que, bien entendu, le jar contenant 
l'application elle-meme. Cependant, elle peut comporter aussi une section inti- 
tulee nativelib precisant les ressources natives requises pour le fonctionnement 
d'une application. Or, dans le cas de l'application developpee par BlueWeb, 
nous devons justement utiliser cette balise car, ne l'oublions pas, SWT utilise 
une bibliotheque native ( . dll sous Windows ou . so sous Unix) pour le lien avec 
la plate-forme materielle. 

II faut done modifier notre descripteur de deploiement .jnlp pour prendre en 
compte cette modification. 

La section precedente mentionne l'utilisation de jar signes, mais de quoi s'agit-il ? 
En fait, les techniques mathematiques dites de cryptographic permettent d'assi- 
gner des valeurs identifiant l'emetteur d'un message ou le createur d'un docu- 
ment. II s'agit done de signer numeriquement des documents permettant d'ins- 
taurer une confiance pendant des echanges - a la facon de la carte d'identite 
attestant de votre identite. Cette confiance peut-etre renforcee via certaines 
societes comme Thawte, qui s'elevent au rang d'autorite de certification (CA). 
Dans le cas du deploiement via Java Web Start, il s'agit de donner a l'utilisateur 
qui se voit proposer un message lui demandant s'il veut bien installer l'applica- 
tion sur son poste, un gage de confiance pour qu'il accepte de le faire. II s'agit en 
fait de le rassurer, puisque la signature du document (ici une archive au format 
jar) ne modifie en rien le contenu de ce document. 

La manipulation de cles publiques et privees et la signature de jar est une tache 
assez ingrate et lourde, que nous devons automatiser. Pas de probleme, Ant 
vient a notre rescousse. . . 

Empaquetage de l'application : integrer la signature de 
jar dans un build-file Ant 

Comme toute equipe de developpeurs, l'equipe BlueWeb chargee de l'applica- 
tion de gestion des signets aime menager ses efforts. Utilisant deja Ant pour 
diverses tidies, elle decide naturellement de lui confier cette nouvelle charge. 
Cette etape d'empaquetage de l'application est une des illustrations de la puis- 
sance d'Ant et permettrait de justifier a elle seule l'utilisation de cet outil. En 
effet, la tache est repetitive, peu enthousiasmante et done toute designee comme 
source d'erreurs difficiles a detecter. 

Cependant, il faut prealablement se doter des outils necessaires a la signature de 
documents, le minimum vital en la matiere etant la possession d'un certificat. 

Creer un trousseau de cles avec les outils du JDK 

Un certificat est une cle numerique entreposee dans un trousseau (comme toute 
cle) : le keystore. Le JDK integre tout ce qu'il faut pour cela, en particulier l'outil 
keytool concu pour la gestion des cles numeriques. Son utilisation dans le cas de 
BlueWeb est la suivante, pour creer un trousseau (le keystore) : 
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Utilisation de I'outil keytool pour creer un certificat de test 




keytool -genkey -keypass bdncompl -storepass blueweb 
Quels sont vos prA©nom et nom ? 
[Unknown] : 

Quel est le nom de votre unitA© organisationnelle ? 

[Unknown] : blueweb 
Quel est le nom de votre organisation ? 

[Unknown] : rd 
Quel est le nom de votre ville de rABsidence ? 

[Unknown] : space 
Quel est le nom de votre A©tat ou province ? 

[Unknown] : 

Quel est le code de pays A deux lettres pour cette unitA© ? 
[Unknown] : FR 

Est-ce CN=Unknown, OU=blueweb, 0=rd, L=space, ST=Unknown, C=FR ? 
[non] : oui 

Le trousseau de cles est maintenant cree (dans le repertoire home) sous le nom 
.keystore. Nous pouvons passer a la signature des documents... 

Signer ses jars avec signjar 

La encore, le travail est minime puisque Ant integre une tache dediee a cet 
usage : signjar. Voici un petit build-file de test utilise par BlueWeb. 



Script Ant utilise pour signer un fichier jar avec notre cerl 




<project name="test signature jar" default="main"> 
<target name="main"> 

<echo>Signature du jar</echo> 

<signjar jar="test. jar" alias="mykey" storepass="123456" 

keystore="/home/jerome/. keystore" keypass="bdncompl"/> 
<echo> signature finie. .</echo> 
</target> 
</project> 

En sauvant ce build-file sous le nom chap6-build-sign.xml, vous obtenez (au 
chemin pres) une sortie du type : 



Lancement du script 




ant -buildfile chap6-build-sign.xml 
Buildfile: chap6-build-sign.xml 
main: 

[echo] Signature du jar 
[signjar] Signing Jar : /shared/public/Mes documents/test. jar 

[echo] signature finie.. 
BUILD SUCCESSFUL 
Total time: 5 seconds 

Les elements necessaires a l'integration dans un processus de build sont a pre- 
sent tous reunis, il ne reste plus qua les integrer dans vos projets. 



Capture d'ecran et accents mal geres 

Les symboles copyright et autres caracteres etran- 
ges sont simplement le resultat d'une mauvaise 
gestion de I'encodage de caracteres francais dans 
une console. La capture omet la saisie du mot de 
passe permettant d'acceder au trousseau de cles. 



ALLER PLUS LOIN Autorite de certification 

Bien entendu, pour une utilisation en interne et 
pour un exemple, il est inutile de se compliquer 
la vie. En revanche, le choix des mots de passe 
(ou pass-phrase) est reellement important pour 
une utilisation professionnelle face a des clients. 
Ici, on a utilise des certificats auto-signes, sans 
la moindre certification par une autorite tierce. 
C'est amplement suffisant techniquement, mais 
completement inutile pour un reel deploiement, 
ou il est indispensable d'acheter un certificat en 
contactant Verisign ou une autre autorite de 
certification reconnue en standard par les navi- 
gateurs. 



< Ce fichier tres simple montre comment utiliser la 
tache signjar. Par defaut, keytool cree le 
certificat dans le repertoire home de I'utilisateur. 
On peut remarquer I'utilisation de deux mots de 
passe distincts dans ce build-file, I'un permettant 
d'acceder au trousseau de cles (123456 dans 
cet exemple), I'autre etant associe a la cle (alias 
mykey par defaut). 



A LA LOUPE Certificat unique pour les jars 
utilises par Java Web Start 

Java Web Start requiert que tous les jar neces- 
saires a I'execution d'une application soient 
signes avec le meme certificat. Par consequent, 
si vous utilisez un jar deja signe par son 
auteur, il faut prevoir de refaire I'empaquetage 
dece code pour pouvoirledistribue, 



On peut remarquer la relative lenteur de cette 
tache (5 secondes). C'est tout a fait normal etant 
donne les calculs effectues et la taille du fichier de 
test utilise (le fichier jar original pesant pres 
d'un Mo). 
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Deploiement sur le serveur web 



ALLER PLUS LOIN 

Services de I'API Java Web Start 

La vision donnee par cette application est un 
peu reductrice puisqu'elle s'affranchit, en raison 
de son architecture, des problemes d'ecriture/ 
lecture sur le disque du poste client ou de pro- 
blemes d'impression. Dans le cas d'applications 
necessitant de telles fonctionnalites (comme 
c'est le cas pour le Notepad distribue par Sun), il 
faut alors s'orienter vers les API JNLP offrant la 
notion de Services. Differents services sont dis- 
ponibles (lecture, ecriture, impression, etc.), 
tous s'utilisant assez simplement et s'obtenant 
par lookup (recherche) sur I'objet 
ServiceManager. La encore, c'est une autre 
histoire... 



Une fois votre application prete a etre mise en production, il ne reste plus qua la 
placer dans le repertoire convenable sur votre machine faisant office de serveur 
web. Pour cela, dans la majeure partie des configurations, il ne s'agit que d'une 
simple copie de fichiers. La encore, Ant peut vous etre utile. Nous laisserons le 
soin au lecteur diligent de realiser un petit build-file accomplissant cette fonc- 
tion ou de l'integrer dans un des fichiers deja present.es. II est inutile de rappeler 
que la documentation Ant vous sera utile, en particulier la section detaillant la 
tache copy. 

Repercussions sur le code client pour l'equipe BlueWeb 

En proposant un mode de deploiement par le Web, Java Web Start nous permet 
de diffuser elegamment notre application via un reseau (Internet ou intranet) en 
utilisant le plus commun des protocoles : HTTP. En revanche, on peut se 
demander quelles sont les repercussions, sur notre code client, de l'empaquetage 
sous forme de jar signes requis par cette technique. 

II faut bien comprendre que la seule difference se situe au niveau de l'empaque- 
tage et concerne faeces aux ressources (images, textes, sons s'il y a lieu). 

La manipulation de ressources contenues dans f archive d'une application distri- 
bute via Java Web Start est assez lourde et un peu delicate. Le programmeur (de 
la partie cliente) est ainsi oblige d'utiliser la methode getResourceAsStream() de 
la classe java.lang.ClassLoader pour charger une icone ou un fichier de confi- 
guration. Cette difficulte n'est pas insurmontable, mais elle alourdit le code et 
peut desarconner un jeune developpeur. 

Void un exemple de code issu de la documentation officielle Sun montrant 
comment charger des icones stockees dans le jar contenant l'application : 

Extrait de code montrant le travail necessaire pour instancier une icone contenue 
dans un jar 

// Get current ciassloader 

CiassLoader ci = this.getCiass() .getCiassLoader() ; Q 

// Create icons 

Icon savelcon = new ImageIcon( c~l .getResource( "i mages/save. gif" )); Q 
Icon cutlcon = new ImageIcon( cl .getResource( "images/cut. gif" )); 

La premiere etape Q consiste done a obtenir une instance de la classe 
ClassLoader a partir de l'instance courante (et de la methode getGassO ren- 
voyant une instance de la meta-classe Class associee) tandis que la seconde 
etape © utilise la methode getResourceO pour instancier l'icone. 

II faut rappeler brievement que Java utilise des objets, dont le role est d'assurer le 
chargement des classes, tout en veillant a ne pas enfreindre les regies de securite 
(implementees dans I'objet SecurityManager). Java est dote d'une faculte de 
chargement des classes dynamiques, s'appuyant en partie sur les objets de la 
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classe Class, qui permet de manipuler des classes, attributs ou methodes dyna- 
miquement. Les methodes getResourceO et getResourceAsStream sont utilisees 
pour piocher des ressources (fichiers textes, sons, icones). 

Cette explication est loin d'etre simple. Et pourtant, le code omet par souci de 
simplicite la gestion des exceptions. 

En fait, pour des taches aussi triviales qu'afficher des icones, images ou lire un 
fichier de configuration, il existe une alternative beaucoup plus simple et convi- 
viale, qui permet de prendre un peu de recul par rapport a la technologie sous- 
jacente. 

Rachel, un auxiliaire de choix 

La bibliotheque Rachel a justement pour but d'executer ces taches triviales. 

Comme enonce lors d'un chapitre precedent, l'idee de cette bibliotheque est ► httpV/rachel sourceforge net 
simple mais tres ingenieuse : elle consiste a proposer un nouveau type d'URL et a 
associer dynamiquement (lors de l'initialisation de l'application par exemple) une 
classe StreamHandler sachant comment traiter les URL utilisant ce protocole. 

Par la suite, on beneficie directement du fait que nos ressources en tant qu'URL 
seront traitees comme s'il s'agissait de fichiers locaux ou de pages web. 

On pourrait done avoir la ligne suivante dans notre application de gestion des 
signets : 

URL signetlconUrl = new URL( "cl ass ://BlueWebAnchor/i mages/si gnet.gif" ); 

Si Ton a pris la peine de declarer comme suit notre StreamHandler sachant gerer 
le protocole dont les URL commencent par class:// : 

URL.setURLStreamHandlerFactory( new VampUrl FactoryO ); 

ce petit effort permet incontestablement de simplifier le code et de s'eviter des 
tracas par la suite car la gestion des ClassLoaders dans Java Web Start est loin 
d'etre simple... 

Ainsi paree, l'equipe BlueWeb se trouve dans une situation plus confortable et 
peut apprehender le developpement plus sereinement. Lors du codage malheu- 
reusement, l'equipe s'apercoit que les temps de developpement sont considera- 
blement rallonges par la lourdeur inherente au mode de deploiement via Java 
Web Start. En effet, une fois le code compile, l'equipe cliente est obligee d'uti- 
liser le build-file permettant de signer les jar, de les deposer sur le serveur web, 
puis de relancer l'application. Elle constate que la version 1.1 de Java Web Start 
n'est pas exempte de bogues dans la gestion des versions, bogues qui obligent a 
effacer a la main certains fichiers sur les machines de developpement... Bref, 
cette approche n'est pas concluante pour la productivite de l'equipe (plusieurs 
minutes perdues pour une modification de quelques secondes). 
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B.A.-BA Encapsuler 



Ce terme est un des mots-cles en programmation 
objet et une des cles du succes si vous voulez obte- 
nir du code reutilisable et robuste. II traduit I'idee 
de cacher les details de votre implementation en 
ne proposant qu'une interface (face visible) la plus 
stable possible. Pourquoi faire cela ? Moins le pro- 
grammer est lie aux details de votre implementa- 
tion, plus vous avez de maitrise sur celle-ci. Or, il 
faut bien se convaincre qu'un projet vit, et que les 
choix faits aujourd'hui peuvent etre remis en cause 
demain. Comment mettre ce principe en pratique ? 
II suffit de cacher vos attributs (visibilite privee) et, 
comme suggere dans cet exemple, d'utiliser des 
couches d'abstraction permettant de vous premu- 
nir contre d'eventuels changements de strategie. 



ATTENTION Le juste equilibre 

Vous devrez toujours veiller a conserver un equi- 
libre raisonnable entre performance et niveau 
d'abstraction dans votre code. Car si les couches 
d'abstraction font gagner en stabilite, elles 
alourdissent vos applications en terme de per- 
formances. 



II y a la un reel desir, pour l'equipe, de s'abstraire du mode de deploiement, qui 
dans ce cas a de trop grandes repercussions sur le travail. En reflechissant au 
probleme, l'equipe BlueWeb, finit par tirer profit de l'utilisation de Rachel. 
Rachel permet en effet de creer un denominateur commun lors de faeces aux 
ressources puisqu'il est evident que pour un deploiement classique, l'acces a un 
fichier peut se faire par des URL du type : file://images/monicone.gif, alors qu'avec 
Rachel l'acces a une image lors du deploiement via Java Web Start se fera par 
une URL du type : class://MonAncre/images/monicone.gif. 

Pour illustrer le probleme rencontre par l'equipe de developpement, rappelons 
que pendant la phase de developpement d'une version, les developpeurs utilisent 
des fichiers (done accessibles via des file://), alors qu'une phase de tests de version 
se fait sur une version empaquetee utilisant des fichiers jar. L'acces aux res- 
sources etant different dans ces deux contextes, il est important de tenter de 
l'uniformiser. C'est ce que permet Rachel. 

Les design pattern en action : Adaptateur, Singleton et Factory 

L'equipe se propose d'utiliser un composant qui permette de faire abstraction du 
mode de deploiement. Ce dernier sera responsable de creer, dans le contexte 
adapte, l'URL permettant enfin d'acceder a nos fichiers. 
Lidee maitresse peut etre resumee par les diagrammes de classe et de sequence 
UML ci-apres. II s'agit simplement d'ajouter un niveau d'abstraction et de cacher 
l'utilisation de Rachel de maniere a encapsuler les appels a cette bibliotheque. 



IResourceAdapter 

getUrlQ 

A* 

creates 



ResourceAdapterFactory 



R esourceA dapterF actoryO 
createObjectO 
qetlnstanceQ 

Figure 6-5 Le design pattern Adapter en action 

Cette conception mile differents design patterns et merite un peu d'attention. 

Le Singleton (mime nom en francais) vise a controler le nombre d'objets ins- 
tancies d'une classe. Dans son implementation la plus classique, ce nombre est 
reduit a 1, d'ou le nom... Dans le schema, notre objet Fabrique (Factory) est 
code suivant ce principe assurant l'unicite des instances d'une classe. 



AnAdapter 



getUrlO 
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«description» 
sequencement du 
precede d'obtenti on 
d'uneURL. 



«comment» 
lei on voit en action 
plusieurs DP : 
le Singleton, la Factory 
et le Pattern Adapter. 



Figure 6-6 Obtention d'une URL 



Le codage d'un singleton implique sur la classe Singleton les conditions 
suivantes : 

• quelle ait un constructeur prive (qu'on ne peut done pas appeler de 
l'exterieur) ; 

• quelle mette a disposition l'instance par une methode statique (qui ne peut pas 
etre instanciee par un constructeur public) classiquement appelee getlnstance () . 



DESIGN PATTERN L'adaptateur 

Le design pattern Adapter (adaptateur en francais) a pour but d'adapter une interface exposee 
par une classe a une autre interface ou de simplifier ('implementation d'une interface. Une utili- 
sation remarquable de ce motif de conception est faite dans la bibliotheque graphique AWT, 
dans le domaine de la gestion des evenements. En effet, les ecouteurs d'un type d'evenements 
{Listener) sont des implementations d'interfaces parfois lourdes. Ainsi I'interface l/Wndow/./'stene/' 
permet de reagir dans le cas d'evenements de fermeture, ouverture, mise en icone d'une fenetre. 
Si un developpeur veut juste reagir a un de ces cas, disons la fermeture d'une fenetre 
(windowClosedO), il peut au choix implementer toutes les methodes requises par I'interface 
(solution lourde) ou heriter de la classe Wi ndowAdapte r, qui fournit des implementations vides 
a toutes les methodes de cette interface. Cette derniere solution est evidemment beaucoup plus 
rapide. 



DESIGN PATTERN Singleton 

Ce motif de conception a pour but de maTtriser le nombre d'instances d'une classe au sein d'un 
contexte (machine virtuelle en Java). II tire son nom du cas particulier frequent oil ce nombre 
vaut un. II est generalement de coutume de conjuguer ce design pattern avec le design pattern 
Factory, de maniere a s'assurer qu'une seule instance de notre usine a objets est disponible. 



DESIGN PATTERN Factory 

Ce motif de conception a pour but de proposer un objet realisant la construction d'autres objets : 
une usine a objets. Pourquoi une telle conception ? Cela sert pour camoufler les veritables clas- 
ses d'implementation ou encore pour permettre de modifier la classe utilisee suivant un parame- 



He oui, le constructeur est prive ! 



Cette methode est le passage oblige depuis 
I'exterieur pour obtenir une reference sur cette 
classe (voir return SingletonDemo, instance tant 
desiree...). 



POUR ALLER PLUS LOIN 
Paquetage de securite JCE 

On ne peut qu'inviter le lecteur a se pencher sur 
la conception du JCE (Java Cryptographic Envi- 
ronment), qui propose via sa structuration en 
SPI (Service Provider Interface, ou interface de 
fournisseur de services) une tres belle illustra- 
tion de ce que Ton peut faire avec le design pat- 
tern Factory. 



Prenons l'exemple du code Java suivant : 

Exemple de classe illustrant le codage d'un singleton 

public class SingletonDemo{ 

// la variable singleton 

// va etre utilisee par getlnstance() puisque l'on desire 
// que cela soit la seule reference disponible 
private static singletonlnstance = new SingletonDemoO ; 

private SingletonDemo(){ 

// du code d'init. . . 
} // constructeurO 

public static SingletonDemo getlnstance(){ 
return singletonlnstanceO ; 

} // getlnstanceO 

// plus tout le code des services proposes par cette classe... 
} 

Le design pattern Factory (Fabrique, Usine en francais) vise a decoupler le 
client des choix d'implementations faits par le codeur d'une API. Cette facon de 
penser son code permet de s'adapter a differentes situations (contextes) sans que 
le code client soit touche. D'une utilisation extremement repandue, on le 
retrouve a de nombreux endroits dans le JDK comme dans des produits a large 
audience et s'avere tres souvent couple au Singleton. Ainsi, le paquetage 
java.util met a disposition la classe Calendar (abstraite) permettant de mani- 
puler dates et calendriers. La documentation de l'API montre clairement que 
cette classe est en fait une Factory ! Le paquetage java.net lui aussi utilise ce 
design pattern pour s'abstraire du protocole ; c'est d'ailleurs grace a cela que 
Rachel (vue precedemment) nous propose une solution aussi elegante et simple 
pour gerer faeces aux ressources. 

Pour cela, il faut s'assurer que le programmeur client manipule des classes abs- 
traites (ou interfaces) sans jamais savoir quelle classe d'implementation est 
effectivement utilisee pour rendre le service demande. 
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En resume... 

Ce chapitre montre comment utiliser de maniere pragmatique Java Web Start avec : 

• Ant, pour faciliter la creation des jar signes et le deploiement sur le serveur 
web ; 

• certains design patterns, de maniere a s'adapter a differents contextes en 
limitant les repercussions. 

Bien entendu, tout n'a pas ete dit sur Java Web Start ni sur les design patterns 
mentionnes, mais le lecteur motive saura tirer profit de cette introduction pour 
aller glaner plus d'information sur Internet ou chez son libraire... 

On peut retenir que Java Web Start aborde sous un tel angle s'avere etre une 
solution tres interessante, puissante et naturellement integree dans votre poste 
client (livree avec les JRE recents). 



chapitre 




Audit du code 
et qualite logicielle 



La qualite logicielle n'est pas une utopie mais sous-entend 
organisation, discipline et procedures. Voyons quelques best 
practices permettant de gagner en productivity dans le cas du 
travail en equipe. Pour cela, nous nous appuierons sur des indi- 
cateurs, les metriques de code, ainsi que sur des documents 
precisant les conventions de nommage au sein d'un projet/ 
entreprise. 



SOMMAIRE 

► Charte et conventions de 
codage 

► Metriques 

► Tests unitaires 

► Directives d'importation 

► Architecture 

MOTS-CLES 

► Audit 

► Metrique 

► Qualite 



Chartes et conventions de codage 



REMARQUE L'hypothese judicieuse des 
besoins en constante evolution 

La prise en compte de revolution des besoins dans 
les methodes memes de conception est une des 
forces de I'eXtreme Programming. En effet, les 
besoins logiciels evoluent tres vite. C'est un fosse 
qui separe I'ingenierie logicielle de I'ingenierie 
civile. 

03 J.-L. Benard, L. Bossavit , R. Medina , 
D. Williams. - Gestion de projet extreme 
Programming, avec deux etudes de cas. 
Eyrolles, 2002. 



OUTIL Convention 
de nommage d'Ambysoft 



► http://www.ambysoft.com/ 
javaCodingStandards.html 



Chaque societe avait pour habitude de re-developper sa charte de codage, docu- 
ment officiel, fixant avec precision comment nommer une methode ou un 
attribut ou encore comment indenter son code source. 

Ceci va a l'encontre de la logique et de l'optique generate propice aux developpe- 
ments objets. Commencons par nous interroger sur la disponibilite via Internet de 
tels documents. Une simple requete avec Google et quelques mots-cles permet de 
trouver de nombreux pointeurs. Parmi ceux-ci, citons la convention de nommage 
d'Ambysoft, qui est reellement un document indispensable. C'est d'ailleurs cette 
convention que BlueWeb a choisie. Pourquoi utiliser un tel document, a priori 
trop important ou complexe pour nos besoins ? Simplement parce que le propre 
des besoins est d'evoluer- I'eXtreme Programming en tient parfaitement 
compte - et une equipe pouvant fluctuer, il est vital de faciliter l'incorporation de 
nouveaux arrivants en faisant en sorte qu'ils ne soient pas perturbes. 

Une convention comme celle de Scott Ambler a le merite de rassembler diffe- 
rentes pratiques couramment employees par la majorite des developpeurs Java. 
Done, adopter une telle convention c'est aussi faciliter le dialogue avec toutes les 
communautes de developpeurs (assistance technique, forums, stagiaires ou nou- 
veaux arrivants dans l'equipe). 

L'effet Stroop (voir encadre) est un effet scientifiquement demontre, via les 
experiences du psychologue de meme nom, nous forcant a prendre en compte 
dans tout projet les limites du cerveau humain. Celles-ci ont un effet immediat 
sur la gestion a long terme d'une application informatique et notamment sur la 
phase de maintenance. En effet, il est evident que Ton est habitue a reagir a cer- 
tains stimuli ; ainsi, un nom de classe du type IUnNom. java fait penser a un nom 
d'interface d'apres les conventions en vigueur dans de nombreux projets Java. 
Une mauvaise utilisation de ces notations peut done induire des pertes de temps 
indeniables lors d'une phase de recherche de bogues. 



B.A.-BA Conventions de nommage et digression sur l'effet Stroop 

Les conventions de nommage sont consignees dans des documents souvent indigestes mais qui 
sont d'une necessite absolue lors d'un developpement collaboratif. lis permettent en effet de 
donner une cohesion a I'ensemble du code source produit par une equipe. II en decoule des repe- 
res visuels permettant de faire gagner beaucoup de temps. Ces reperes sont le pendant positif de 
ce qu'il est convenu d'appeler l'effet Stroop. Le psychologue J.Ridley Stroop a realise en 1935 
une experience d'une simplicite confondante pour mettre en evidence les limites du cerveau 
humain, via I'ecriture de noms de couleur (bleu ecrit en rouge, puis rouge ecrit en bleu et ainsi de 
suite) suivie de la lecture a haute voix. Les resultats de cette experience sont edifiants et permet- 
tent de comprendre les desastres sur le plan professionnel d'une mauvaise convention de codage 
ou, encore pire, de I'absence de convention. Le protocole de cette experience et ses resultats 
sont publies sur le Web. En un mot, I'etude prouve I'existence d'interferences entre differents 
types de stimuli sur notre cerveau, en particulier I'influence des couleurs sur ('interpretation de 
mots. Elle permet de comprendre I'importance capitale de la presentation du code en matiere de 
maintenance du code. 
► http://psychclassics.yorku.ca/Stroop/ 
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On comprend done bien l'interet de ce type de document pour prevenir les 
notations abusives et batir des fondations communes a tous les intervenants 
d'un projet. On pourrait, a titre d'exemple, regrouper toutes les constantes d'un 
paquetage dans une classe Constants en faisant ainsi une Booch Utility class, pre- 
fixer les interfaces par la lettre I pour distinguer visuellement dans un code 
source les classes abstraites des interfaces, etc. 

L'outil Checkstyle 

Checkstyle est un outil visant a assurer le respect de certaines conventions de 
nommage, afin de garder un style de codage propre et simple. Bien entendu, cet 
outil peut etre integre dans un build-file Ant via la tache du meme nom. 

II est extremement configurable (supporte par defaut la convention de nom- 
mage de Sun issue des JSR). II permet de choisir outre la convention de nom- 
mage a respecter, le type de sortie (fichier texte ou XML), ce qui permet d'auto- 
matiser la generation de rapports HTML envoyes par courrier electronique si 
Ton ajoute a cette tache l'usage des taches styl e et man 1 . 



B.A.-BA Booch utility class 



Nom donne (par reference aux travaux de 
Grady Booch, un des inventeurs d'UML et metho- 
dologiste de renom) a des classes ne pouvant etre 
instanciees et offrant done des services de portee 
de classe. 



► http://checkstyle.sourceforge.net/ 



Obtention d'un rapport avec Checkstyle 

Ainsi, le responsable Qualite chez BlueWeb desire verifier chaque jour la con- 
formite des sources produites par l'equipe avec les conventions adoptees (Sun) et 
souhaite que le contenu de cet audit de code lui soit envoye par courrier electro- 
nique sous la forme d'une page HTML. Le serveur de courrier de Blueweb 
etant la machine nommee mai 1 . bl ueweb . com, le build-file suivant permet 
d'accomplir ces objectifs. 

Script Ant declenchant la production d'un rapport d'audit du code source 

<project name="BlueWeb" default="mai n" basedi r=" . "> 
<target name="init" description ="cree les repertoires utilises 
par la suite"> 

<!-- utilise la task mkdir pour creer les repertoires --> 
<mkdir di r="reports"/> 
<mkdir di r=" reports/html "/> 
</target> 

<!-- declare la task puis l'invoque --> 
<target name="declare" depends="init"> 

<!-- declare la task checkstyle --> 

<taskdef name="check" 

cl assname="com . puppycrawl . tool s . checkstyl e . CheckStyl eTask" 

/> 

</target> 

<!-- supprime les fichiers crees --> 

<target name="clean" description="prepare le grand menage... "> 

<delete di r="reports"/> 
</target> 



Le build-file est organise en quatre cibles 
(targets): main (cible principale), clean (des- 
truction des fichiers produits), declare (qui 
declare la taskdef) et i ni t. 
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L'execution de checkstyle se fera sur tous les 
fichiers Java (**/*. java) contenus dans le 
repertoire src. Ici, la sortie choisie est de type 
XML (formatter type="XML"). 
Le fichier produit est traite par la tache style 
pour operer line serie de transformations via 
XSLT. Attention, cette tache requiert Xalan, done 
se referer au manuel Ant pour I'installation de 
cette bibliotheque. 

Cette tache attend un parametre style= 
"checkstyle. xsl", qui va definir le fichier 
XSL utilise pour la transformation. Q 



La tache mail, elle aussi, requiert un certain 
nombre de bibliotheques (action, jar, 
mail .jar). Q 

Le parametre mai 1 host contient I'adresse IP ou 
le nom (entree dans le DNS) du serveur SMTP 
utilise pour I'envoi. Pour les utilisateurs de distri- 
butions Linux ayant installe Sendmail ou Postfix, 
cette valeur peut-etre 1 ocal host. 



<! — target principale (par defaut) — > 

<target name="main" depends="declare" description^ 

"Target principale, depend de la target declare"> 
<check fan 1 ureProperty="checkstyl e . f ail ure" 
fail0nVio1ation="fa1 se"> 
<fileset dir="src" includes^'**/* .java"/> 
<formatter type="xml " toFi 1 e=" reports/checkstyl e_report . xml "/> 
</check> 

<!-- transforme le fichier XML de sortie en HTML via XSLT --> 
<style in="reports/checkstyle_report.xml " out="reports/html/ 
checkstyl e^report. html" style="checkstyle.xsl "/> © 

<!-- envoi d'un courrier electronique s'il y a des erreurs --> 
<mai 1 f rom="mi chel @bl ueweb . com" 

tol i st="mi chel @bl ueweb . com , dev@bl ueweb . com" 
mai 1 host="mai 1 . bl ueweb . com" 
subject="Checkstyle violation(s) in project 

${ant. project, name}" 
f i 1 es=" reports/html /checkstyl e_report . html "/> 
</target> 
</project> 

Q Des exemples de fichiers tel checkstyl e.xsl sontlivres dans le repertoire etc 
d'Ant ($ANT_HOME/etc sous Unix et %ANT_HOME%\etc sous Windows). La version 
checkstyl e-f rames . xsl pouvant poser probleme, on conseille d'utiliser le fichier 
checkstyl e-nof rames.xsl en lieu et place. 

A ce stade du build Q, nous disposons d'un fichier HTML (dans le repertoire 
reports/html) qu'il ne reste plus qua envoyer par courrier electronique. 

Q Le manuel Ant, une fois de plus, vous aidera a installer ces bibliotheques .jar. 
Dans cet exemple, le responsable qualite de BlueWeb a demande a l'administra- 
teur systeme de creer sur son serveur de courrier un alias dev@bl ueweb . com con- 
tenant la liste des developpeurs du projet. 



Utilisation de metriques 

Les metriques de code sont des indicateurs (rien de plus) permettant d'evaluer 
differents parametres dont : 

• le degre de dependance d'un paquetage par rapport aux autres paquetages ; 

• le degre d'abstraction d'un paquetage (plus il y a d'interfaces et de classes 
abstraites, plus ce degre est fort). 

Leur interet pratique est de pouvoir visuellement jauger le degre de 
« reutilisabilite » d'un paquetage. En effet, plus un paquetage est dependant des 
autres, moins il sera reutilisable et stable. Le pragmatisme veut que Ton ait un 
certain nombre de paquetages tres stables (definissant des interfaces et classes 
abstraites), puis d'autres paquetages d'implementation proposant du code pour 
les interfaces definies. 
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Exemple : le paquetage java.net 



Dans ce paquetage de base du JRE, Sun a decide d'opter pour une tres grande 
flexibilite qui vous permet en tant que developpeur d'utiliser d'une maniere 
identique une URL pointant vers un site web via HTTP ou HTTPS (SSL over 
HTTP), vers un site FTP ou encore sur un serveur de news (NNTP). Tout ceci 
se fait de maniere transparente pour le developpeur client et reclame done une 
mecanique d'abstraction du protocole basee sur une interface Java. C'est juste- 
ment le propos de l'interface java.net.URLStreamHandlerFactory, qui permet 
d'associer a un nom de protocole (http par exemple) une classe heritant de la 
classe abstraite java.net.URLStreamHancner. 

Ainsi, d'une maniere tres simple, vous pouvez ajouter un protocole lors de l'execu- 
tion de votre programme et associer a son nom la classe permettant de le gerer. 

C'est d'ailleurs ainsi que dans la documentation de Rachel, son auteur 
Geral Bauer propose d'utiliser son paquetage d'acces a des ressources contenues 
dans des jar delivres sur le poste client via JNLP, le protocole developpe pour 
Java Web Start. 

| URL.setURLStreamHandlerFactoryC new VampUrl FactoryO ); 

Cette ligne permet d'ajouter un nouveau protocole... Les URL seront du type 
class://unchemin/vers/une/ressource. On enregistre la factory (VampUrl Factory) 
aupres de la classe URL via la methode statique setURLStreamhandlerFactory. 

Puis vous creez vos URL a I'aide des lignes de code qui suivent : 

URL appIconUrl = new URL( "class://ThemeAnchor/images/inform.gif" ); 
Imagelcon applcon = new ImageIcon( appIconUrl ); 

Ceci permet de creer une icone a partir d'une image contenue dans un jar dis- 
tribue via Java Web Start. La classe URL va jouer le role de proxy sous-traitant a 
la bonne factory (celle en charge du protocole desire) la charge d'instanciation de 
l'URL et de sa gestion. 



OUTIL Rachel 



Comme nous I'avons vu au chapitre precedent, 
Rachel est une bibliotheque permettant de mani- 
puler le contenu d'archives au format jar d'une 
application distribute via Java Web Start. On ne 
saurait que trop chaudement recommander cette 
bibliotheque, qui permet de diminuer considera- 
blement le travail du developpeur dans le cas d'un 
deploiement via Java Web Start. 
► http://rachel.sourceforge.net 



Outil rattache aux metriques : J Depend 

JDepend est un outil developpe par Jim Clarke qui fournit des metriques quali- 
fiant la qualite de conception du code pour un ensemble de paquetages Java. 



► h ttp ://www .clarkware.com/software/ 
JDepend.html 



ALTERNATIVE JMetra 

JMetra est un outil recent proposant aussi des metriques de code et qui 
s'integre tres bien a Ant. La visite de I'adresse suivante peut vous 
interesser : 

► http://www.hypercisioninc.com/jmetra. 

Bien d'autres outils peuvent etre envisages. Une recherche sur Internet avec 
les termes java metrics code devrait vous fournir de nombreuses 
autres pistes. 



ALTERNATIVE Javancss 

L'outil javancss fournit un certain nombre de metriques sur votre code. II 
peut etre un complement interessant a JDepend. II ne propose neanmoins 
aucune tache Ant, ce qui fait que son utilisation se borne pour I'instant a 
une invocation en ligne de commandes. 
► http://www.kclee.com/clemens/java/javancss/ 
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RAPPEL Paquetages 

Cette notion est fondamentale en Java. Elle permet 
de realiser des groupements (hierarchiques) de clas- 
ses par themes. Ceci a pour vocation premiere de 
prevenir tout risque de conflit (collision) entre clas- 
ses. En effet, en prenant un exemple simple, com- 
ment faire pour distinguer votre classe Li st (struc- 
ture de donnees contenant une collection d'objets 
utiles dans votre projet et dotee de certaines fonc- 
tionnalites) de celle fournie par Sun permettant 
d'afficher un composant graphique ? Ce probleme 
est recurrent en informatique et Sun, avec la solu- 
tion des paquetages, adopte une position proche 
(dans I'esprit) de celle du comite de normalisation 
du C++. Les paquetages Java permettent de plus de 
fournir des reperes visuels a votre equipe. 



TAOOBJET Principes 

f ondamentaux de I'objet 

La programmation objet, via une serie de princi- 
pes fondamentaux, a erige une ligne de defense 
tres forte contre les deviances engendrees par 
une mauvaise utilisation d'un langage objet et 
une mauvaise analyse. Ces principes (OCP, DIP, 
ADP, principe de substitution de Liskov, etc.) doi- 
vent figurer dans les bagages de tout utilisateur 
averti des technologies objet. Si Ton reprend 
I'exemple montrant des dependances cycliques, 
le principe ADP (Acyclic Dependancy Principle) 
interdit formellement ce type de dependances. 
Parmi tant d'autres pointeurs possibles, voici 
I'URL d'une excellente presentation (necessite 
OpenOffice.org Impress ou PowerPoint) : 



► http://www.design-up.com/data/ 
principesoo.pdf 

► http://www.cijug.org/presentation/ 




II realise un audit partiel (notre responsable qualite ne doit pas licencier ses 
developpeurs a la simple vue d'un rapport...), mais qui permet quand meme de 
fournir des indicateurs deja significatifs sur la possibilite de maintenir et de reu- 
tiliser du code produit. 

JDepend fournit plusieurs interfaces, dont une en mode console. C'est cette 
derniere que nous adopterons pour les exemples suivants. 

Comprendre les dependances entre paquetages 

Admettons que JDepend produise un resultat du type : 

com.blueweb.ejb 

| com.blueweb.servlets 

|— > com.blueweb.ejb 

Ceci indique : 

• une dependance entre com.blueweb.ejb et com.blueweb.servlets ; 

• puis une dependance entre com.blueweb.servlets et com.blueweb.ejb. 

Nous avons done affaire a une dependance cyclique signifiant que les deux 
paquetages sont profondement lies. Cette dependance est tellement forte qu'il 
est inimaginable de modifier l'un sans recompiler l'autre, leur reutilisation ne 
peut se faire qu'en bloc. Ceci peut bien sur arriver, mais denote generalement 
d'une faiblesse dans la conception, puisque ceci peut signifier : 

• que les deux paquetages n'en font qu'un (ou devraient n'en faire qu'un) ; 

• qu'un des deux paquetages possede une reference non desiree vers l'autre. 

En se replacant sur le plan architectural, un tel resultat montre un gros probleme 
de conception, puisque dans le modele a cinq couches presente dans le chapitre 
consacre a l'architecture, la couche contenant la logique metier (done vraisem- 
blablement com.blueweb.ejb) ne depend en aucun cas de la couche de presenta- 
tion des donnees (com.blueweb.servlets). Cet outil est done pertinent ! 

Voici un autre exemple : 

Icom.blueweb.ui 
| — > com.blueweb.ejb 
| com.blueweb.servlets 
| j— > com.blueweb.ejb 

Quel dommage de ne pas avoir change notre conception, car l'interface gra- 
phique se trouve a present prisonniere des evolutions des paquetages ejb et 
servlets. On constate la encore un cycle entre com.blueweb.servlets et 
com.blueweb.ejb, mais en plus com.blueweb.ui (notre interface utilisateur), qui 
depend d'un paquetage pris dans une relation cyclique, en devient totalement 
tributaire. De nouveau, l'examen de notre modele a 5 couches devrait nous 
montrer qu'on ne souhaite pas qu'une telle chose se produise. 
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Utilisation des indicateurs de paquetages 

JDepend nous fournit toute une serie d'indicateurs chiffres caracterisant chaque 
paquetage (voir tableau 7-1). 

Tableau 7-1 Vue synthetique des indicateurs proposes par JDepend 



CC 


Le nombre de classes concretes du paquetage (done toutes les classes non 
abstraites et sans les interfaces) 


CA 


Le nombre de classes abstraites et d'interfaces d'un paquetage. 


Ca 


Couplage afferent, nombre de classes en dehors de ce paquetage depen- 
dantes de classes(/interfaces) definies dans ce paquetage. 


Ce 


Couplage sortant (efferent), nombre de classes de ce paquetage dependan- 
tes de classes(/interfaces) definies dans un paquetage exterieur. 


A 


Abstraction du paquetage (nombre flottant variant de 0 a 1) 


I 


Instability (nombre flottant variant de 0 a 1) 


D 


Distance a la sequence principale 


C 


Si le paquetage contient une dependance cyclique 



B.A.-BA Interface homme machine (IHM) 

IHM, Ul (User Interface) et GUI (Graphical User 
Interface) sont des mots quasiment interchangea- 
bles dans cet ouvrage comme dans bien d'autres 
documents d'informatique. 



L'instabilite totale d'un paquetage n'est pas problematique en elle-meme, 
puisque si une application ne disposait que de paquetages totalement stables, il y 
a fort a parier quelle ne puisse pas realiser grand-chose d'utile (car bien evidem- 
ment, sans implementation, pas de code execute). Done cet indicateur ne doit 
pas etre considere avec plus d'autorite que de raison. 

En fait, d'apres Robert Martin dans son celebre article : OOD Design Quality 
Metrics en 1994, les paquetages stables (l=0) devraient etre constitues de classes 
abstraites (en Java, par extension d'interfaces), tandis que les paquetages insta- 
bles (l=l) devraient done contenir des classes concretes (non abstraites). 

La ligne « ideale » ou main sequence, d'apres Robert Martin, permet de situer 
nos paquetages relativement a un segment ideal et, par ce biais, de considerer si 
le degre d'abstraction d'un paquetage (indicateur A) est coherent avec son degre 
de stabilite (i), sans tomber dans les extremes rarissimes au sein d'un projet : 

• (1=0, A=l); 

• (1=1, A=0). 

Done, via I'indicateur D {distance from main sequence ou distance a la sequence 
principale), Robert Martin nous propose un moyen de focaliser notre attention 
sur tous les paquetages dont la distance (d) est loin de 0 (done proche de 1). A 
partir de quelle valeur de D faut-il commencer a reexaminer un paquetage ? Un 
chiffre de 0.2 ou 0.3 semble raisonnable, car il ne faut pas tomber dans l'inte- 
grisme... De plus, il faut aussi tenir compte des classes efferentes dont sont 
dependantes vos classes. En effet, certaines classes comme String et certaines 
autres des paquetages de base du JDK ont une stabilite assuree... 



Cet article contient toutes les formules de calcul 
des differents indicateurs, ainsi que de nombreux 
commentaires et exemples. De plus, il propose le 
schema original representant la distance a la 
sequence principale. 

► http://www.objectmentor.com/resources/ 
articles/oodmetrc.pdf 
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La figure 7-1 (issue de l'article de Robert Martin) montre clairement ce qu'est 
la sequence principale. En ajoutant quelques points sur le diagramme, on est a 
mime d'imaginer ce qu'est la distance a la sequence principale. 

Utilisation de JDepend dans un build-file Ant 

En plus de nous donner une vision assez claire de la qualite de conception dans 
notre projet, JDepend s'integre tres aisement dans un build-file, via la tache 
optionnelle DDepend fournie avec Ant. 

Pour cela, n'oubliez pas d'ajouter le fichier optional .jar dans votre classpath. 
Vous trouverez ci-apres un build-file realisant l'invocation de JDepend, la trans- 
formation du rapport produit du format initial XML en HTML puis l'envoi 
d'un courrier electronique. Mise a part l'invocation de la tache j depend, ce 
build-file ressemble a s'y meprendre au precedent. On voit en argument de la 
tache jdepend, un exemple d'utilisation de path-element dans l'attribut 
sourcespath. 

Script Ant demontrant l'invocation de JDepend 



Initialisation ► 



<project name="BlueWeb" default="main" basedir="."> 

<target name="init" description ="cree les repertoires utilises par 
la suite"> 

<! — utilise la tache mkdi r pour creer les repertoires --> 
<mkdir di r="reports"/> 
<mkdir di r=" reports/html "/> 
</target> 
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<target name="clean" description="prepare le grand menage... "> 

<delete di r="reports"/> 
</target> 

<target name="main" depends="init" description="Target principale, 
depend de la target init"> 

<jdepend outputfi1e="reports/jdepend.xml " format="xml "> 

<sourcespath> 

<pathel ement location="src"/> 

</sourcespath> 
</jdepend> 

<styl e i n=" reports/] depend . xml " out=" reports/html /] depend . html " 
style="jdepend.xsl "/> 

<mai 1 f rom="mi chel@bl ueweb . com" 

tol i st="mi chel@bl ueweb . com" 
man 1 host="mai 1 . bl ueweb . com" 

subject="Metriques du projet ${ant. project. name}" 
files=" reports/html /j depend. html "/> 
</target> 
</project> 



< I Supprime les fichiers produits. 



| Target principale (par defaut) 



< Invoque la tache jdepend. 



Transforme le fichier XML de sortie en HTML via 
XSLT. 



Envoi d'un courrier s'il y a des erreurs. 



Tests unitaires : le framework JUnit 



Ce framework, directement issu des pratiques pronees par 1'eXtreme Program- 
ming et mis a disposition par Kent Beck et associes sur le site http://www.junit.org/ 
index.htm, vise a fournir un outil assurant l'execution de tests unitaires et de tests 
de non-regression. Son utilisation presente quelques limitations, mais il permet 
quand meme d'avoir un outil minimaliste assurant un perimetre de fonctionna- 
lites donnees. Son usage est tres repandu, ce qui implique une grande diversite 
d'outils et d'articles gravitant autour de ce produit. 

Nous ne rentrerons pas dans les details d'utilisation de I'outil, ni dans ceux de son 
integration avec Ant, mais ils sont largement commentes et done toute recherche 
sur le Web devrait vous permettre de trouver matiere a son apprentissage. Nous 
nous contenterons de citer les grandes etapes permettant d'utiliser ce framework : 

1 Associer a chaque classe qui doit etre testee, une classe de test heritant de 
juni t . framework .TestCase. 

2 Coder les methodes de tests, une par fonctionnalite de la classe a tester. 

3 Creer vos suites de tests (ensemble d'instances de la classe TestCase), en 
ajoutant vos objets TestCase a une instance la classe junit. framework. 
TestSuite, via la methode addTestC). 

4 Puis lancer la suite de tests via la methode run(). 

5 Eventuellement, regrouper les initialisations necessaires a vos tests dans une 
methode setupO, et proceder a la liberation dans une methode tearDown(). 



A lire 



O J.-L. Benard, L. Bossavit, R. Medina, 

D. Williams, Gestion de projet extreme 

Programming, Eyrolles 2002 
ffl J. Newkirk, R. Martin, extreme Programming in 

Practice, Addison Wesley 2001 
£0 R. Hightower, N. Lesiecki, Java Tools for 

extreme Programming, Wiley 2002 



Le chapitre 3 fournit une presentation synthetique 
de JUnit. 



ALTERNATIVE Jtest de Parasoft 

D'autres outils sont disponibles en ce domaine 
dont certains, comme celui de la societe Parasoft, 
permettent d'aller beaucoup plus loin que JUnit. 
Malheureusement, de tels produits sont payants, 
difficilement accessibles et d'usage peu repandu. 
► http://www.parasoft.com/jsp/products/ 
home.jsp?product=Jtest 
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L'integration de l'execution de vos tests dans votre build-file se fera naturelle- 
ment via une tache optionnelle (Junit) dont le resultat peut lui aussi etre trans- 
forme en HTML, via la tache styl e, puis envoye par courrier electronique via la 
tache mai 1 . Bref, pour vous maintenant rien de neuf a l'horizon. . . 



Mise en forme du code source 



ALTERNATIVE ImportScrubber 



D'autres outils peuvent etre inseres dans votre 
processus de build, et ce de maniere a automatiser 
encore plus I'amelioration du code source partage 
dans votre referentiel CVS. Par exemple, le projet 
ImportScrubber disponible a I'adresse : 
► http://importscrubber.sourceforge.net/ 
permet d'automatiser I'analyse des imports de 
classes presents dans votre code source et de creer 
des classes de sortie conformes aux regies commu- 
nement admises de bonne programmation en Java 
telles qu'eviter des imports de paquetages entiers 
en remplacant cette ligne par autant de lignes que 
de classes de ce paquetage reellement utilisees 
dans votre classe. 



L'aspect purement visuel du code source ayant une importance non negligeable, 
il est bon de se doter d'outils nous permettant d'ameliorer automatiquement la 
mise en forme voire le contenu de notre code source. 

Jalopy, disponible a I'adresse http://jalopy.sourceforge.net, permet de mettre en forme 
votre code source automatiquement en respectant certaines conventions de 
codage telles que : 

• indentation du code ; 

• positionnement des accolades ; 

• ajustement des espaces. 

Bien entendu, Jalopy s'integre en douceur dans votre procedure de build, via une 
tache Ant disponible dans la rubrique plug-ins de ce site. 

Essayons prudemment cet outil en le testant sur notre code source, mais en 
fournissant un repertoire de destination (destdi r), en utilisant la convention de 
nommage par defaut (Sun). C'est justement la fonction du build-file suivant. 



La tache Jalopy ne presente pas de difficulte par- 
ticuliere d'utilisation. Ce build-file montre ici un 
exemple de declaration d'une tache via 
taskdef et la definition du classpath 
(charge tous les jar presents dans le repertoire 
lib de la distribution Jalopy). Attention, vous 
devrez modifier la propriete dir. jalopy de 
maniere a refleter votre installation 
(c : \ j ava\l i bs\ j al opy par exemple). 



Definition de la tache Jalopy. 



tant en forme du code source avec Jalop 

<project name="BlueWeb" default="main" basedir="."> 

<property name="di r. jalopy" value="/dvpt/Java/jalopy"/> 

<! — initialisation --> 

<target name="init" description ="cree les repertoires utilises par 

la suite"> 
</target> 

<!-- supprime les fichiers produits --> 

<target name="clean" description="prepare le grand menage... "> 

<delete dir="dest"/> 
</target> 

<!-- target principale (par defaut) --> 

<target name="main" depends="init" description="invoque jalopy"> 

<taskdef name=" jalopy" 

classname="de.hunsicker . jalopy. pi ugin. ant. AntPlugin"> 
<classpath> 

<f il eset di r="${di r . jalopy}/! ib"> 

<include name="*. jar" /> 
</fileset> 
</classpath> 
</taskdef> 
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<jalopy fileformat="unix" 
history="fi1e" 
historymethod="adler32" 
log1eve1="info" 
threads="2" 
destdir="dest" 
> 

<fi1eset dir="src"> 

<include name="**/*- java" /> 
</fileset> 
</jalopy> 

</target> 
</project> 



Configurer votre propre convention 

Jalopy vous permet d'utiliser la convention de votre choix et ce via un fichier 
XML devant etre appele depuis l'attribut convention « path/vers/ 
convention.xml ». Ceci vous permettra de refleter des parametrages generaux 
tels que : 

• le nombre d'espaces inseres a la place d'une tabulation (indentation) ; 

• le style Kernighan & Richie ou C Ansi (definition du placement des paren- 
theses pour chaque bloc). 

Attention, ce travail est relativement couteux en temps de redaction (du fichier) 
et en temps de test. Nous vous conseillons vivement d'utiliser un fichier existant 
tel que le fichier suivant (fichier Jalopy correspondant a la norme de codage du 
produit Maven, laisse tel quel dans le CVS du projet Maven pour la 
version 1.0b7). 



<jalopy> 

<printer> 

<al ignment> 

<ParamsMethodDef>fal se</ParamsMethodDef> 
<varAssigns>fal se</varAssigns> 
<varldents>f al se</varldents> 
<ternaryExpresssion>false</ternaryExpresssion> 
<ternaryVal ue>f al se</ternaryVal ue> 
</alignment> 

<sorting> 

<vari abl e>f al se</vari abl e> 
<cl ass>f al se</cl ass> 
<modifiers> 

<use>false</use> 
</modifiers> 
<method>f al se</method> 

<order>Static Variables/Initializers, Instance Variables, 
Instance Ini ti al i zers , Constructors , Methods , 
Interfaces, CI asses 

</order> 



Debut du fichier de configuration avec un pre- 
mier bloc permettant de gerer les alignements 
au niveau des definitions de methodes, assigne- 
ments de valeurs, etc. 



Ce deuxieme bloc controle le tri des elements. 
Ainsi, avec cette configuration, on demande a 
Jalopy de ne pas trier les variables ou methodes 
mais de trier les imports. 
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Gestion des lignes vides. Ajoute (si non pre- 
serve) une ligne vide apres la ligne package, le 
dernier import, etc. 



e configuration de Jalopy (su 

<use>true</use> 

<constructor>fal se</constructor> 

<orderModi f i ers>pubi i c .protected , pri vate , abstract , 

stati c , f i nal , synch roni zed , t ransi ent , vol ati 1 e , 

native, strictfp 
</orderModifiers> 
<i nterf ace>fai se</i nterf ace> 
</sorting> 

<blankl_ines> 

<beforeHeader>0</beforeHeader> 

<bef oreCommentSi ngi eLi ne>l</bef oreCommentSi ngi eLi ne> 

<afterLastImport>l</afterLastImport> 

<afterPackage>l</afterPackage> 

<afterGass>l</afterGass> 

<beforeContro~l>l</beforeControl> 

<afterBraceLeft>0</afterBraceLeft> 

<keepUpTo>l</keepUpTo> 

<beforeJavadoc>l</before]avadoc> 

<bef oreCommentMul ti Li ne>l</bef oreCommentMul ti Li ne> 

ofterDecl arati on>l</afterDecl arati on> 

<afterlnterface>l</afterlnterface> 

<afterMethod>l</afterMethod> 

<afterBlock>l</afterBlock> 

<bef oreBl ock>l</bef o reBl ock> 

<bef oreDecl arati on>l</bef oreDecl arati on> 

<af te r Foote r>0</af te r Foote r> 

<af te rHeade r>l</ af te rHeade r> 

<bef oreBraceRi ght>0</bef oreBraceRi ght> 

<bef oreCaseBl ock>l</bef oreCaseBl ock> 

<beforeFooter>0</beforeFooter> 
</blankLines> 
<header> 

<text>/* 

* The Apache Software License, Version 1.1 
(...) 

*/</text> 

<smartModeLi nes>5</smartModeLi nes> 
<keys>The Apache Software License</keys> 
<use>fal se</use> 
</header> 

<whitespace> 

<paddi ngLogicalOperators>true</paddingLogicalOperators> 
<bef oreMethodDecl arati onParenthesi s>f al se 
</bef oreMethodDecl arati onParenthesi s> 
<padddi ngBrackets>f al se</padddi ngBrackets> 
<af te rComma>t rue</af te rComma> 

<paddi ngBi twi seOperators>true</paddi ngBi twi seOperators> 

<paddi ngAssignmentOperators>true 

</paddingAssignmentOperators> 

<bef oreLogi cal Not>f al se</bef oreLogi cal Not> 

<padddi ngTypeCast>f al se</padddi ngTypeCast> 
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nfiguration de Jalopy (suite) 

<paddingRelationalOperators>true 
</paddingRelationalOperators> 
<beforeStatementParenthesis>true 
</bef oreStatementParenthesi s> 

<af terCasti ngParenthesi s>t rue</af terCasti ngParenthesi s> 

<beforeBraces>true</beforeBraces> 

<beforeCaseColon>fal se</beforeCaseColon> 

<paddi ngMathemati cal Operators>true 

</paddingMathematicalOperators> 

<padddingBraces>true</padddi ngBraces> 

<bef oreMethodCal 1 Parenthesi s>f al se 

</bef oreMethodCal 1 Parenthesi s> 
<af terSemi Col on>true</af terSemi Col on> 
<beforeBracketsTypes>fal se</beforeBracketsTypes> 
<padddi ngParenthesi s>f al se</ padddi ngParenthesi s> 
<paddingShiftOperators>true</paddi ngShiftOperators> 
<beforeBrackets>false</beforeBrackets> 
</whitespace> 

<i ndentation> 

<1 abel >f al se</l abel > 

<braceRightAfter>0</braceRightAfter> 

<extends>-l</extends> 

<i mpl ements>-l</i mpl ements> 

<1 eadi ng>0</l eadi ng> 

<conti nati onlf >f al se</conti nati onlf > 

<parameter>-l</parameter> 

<general>4</general> 

<commentEndl i ne>l</commentEndl i ne> 

<f i rstCol umnComments>true</fi rstCol umnComments> 

<conti nati onlf Ternary>false</conti nati onlf Ternary> 

<tabs> 

<size>4</size> 

<use>false</use> 
</tabs> 

<caseFromSwi tch>f al se</caseFromSwi tch> 

<throws>-l</throws> 

<braceLeft>0</braceLeft> 

<deep>30</deep> 

<braceRight>0</braceRight> 

<useMethodCal 1 Params>f al se</ useMethodCal 1 Params> 
<conti nuati on>4</conti nuati on> 
<braceCuddl ed>l</braceCuddl ed> 
</indentation> 

<comments> 
<javadoc> 

<addFi el d>0</addFi el d> 
<remove>f al se</remove> 
<templates> 
<methods> 

<return> * ©return DOCUMENT ME!</return> 
<exception> * @throws SexceptionTypeS DOCUMENT ME! 
</exception> 



Ce bloc agit sur I'indentation (effet d'escalier) du 
code source. Ici, on definit une indentation a 
4 caracteres sans utiliser le caractere tabulation 
(Tab). Ce type de parametrage permet d'eviter 
des desagrements dans le cas de I'utilisation 
d'un outil comme CVS... 



Definition de I'allure des commentaires ; se fait 
en utilisant des modeles (templates). Bien 
entendu, rien de tel qu'un modele pour changer 
de presentation en cas de besoin. . . 
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de Jalopy (suite) 



Ce bloc definit comment sont gerees les separa- 
tions entre les divers blocs d'un programme 
(classes). 



Ce bloc definit la troncature (wrapping) des 
lignes. La valeur utilisee (80 dans ce cas) est la 
valeur generalement admise, car elle permet 
d'eviter au lecteur d'avoir a defiler sur I'ecran 
pour pouvoir lire une ligne de code. 



* DOCUMENT ME!</top> 
/</bottom> 

@param $paramType$ DOCUMENT ME! 



<top>/** | 
<bottom> 
<param> * 
</param> 
</methods> 
</tempiates> 
<tags> 

<in-1ine /> 
<standard /> 
</tags> 

<addG ass>0</addG ass> 
<checkInnerGass>fai se</checkInnerGass> 
<addCtor>0</addCtor> 
<addMethod>0</addMethod> 
<parseComments>fai se</parseComments> 
<checkTags>fai se</checkTags> 
</javadoc> 

<separator> 

<method>Methods</method> 

<stati cVari abi elni t>Stati c van' abi es/i ni ti al i zers 
</staticVariabieInit> 
<ctor>Constructors</ctor> 
<f i 1 1 Character> ■ </f i 1 1 Character 
<interface>Interfaces</interface> 
<i nstancelni t>Instance i ni ti ai i zers</i nstancelni t> 
<i nstanceVari abi e>Instance vari abi es</i nstanceVari abi e> 
<ci ass>G asses</ci ass> 
</separator> 

<f ormatMui ti Li ne>f ai se</f ormatMul ti Li ne> 
<insertSeparatorRecursive>faise</insertSeparatorRecursive> 

<insertSeparator>faise</insertSeparator> 

<removeMui ti Li ne>f ai se</removeMul ti Li ne> 

<removeSi ngi eLi ne>f ai se</removeSi ngi eLi ne> 
</comments> 
<footer> 

<keys /> 

<text /> 

<use>faise</use> 

<smartModeLi nes>0</smartModeLi nes> 
</footer> 

<wrapping> 

<arrayElements>0</arrayElements> 

<af te rTh rowsTypes>f ai se</af te rTh rowsTypes> 

ofterlmpi ementsTypes>fal se</afterlmpi ementsTypes> 

<beforeThrows>faise</beforeThrows> 

ofterChai nedMethodCa~n>false</afterChainedMethodCa~n> 

<afterExtendsTypes>fai se</afterExtendsTypes> 

<paramsMethodCai 1 >f ai se</paramsMethodCai 1 > 

<1 i neLength>80</i i neLength> 

<beforeExtends>faise</beforeExtends> 

<beforeOperator>true</beforeOperator> 

<paramsMethodDef>faise</paramsMethodDef> 



158 



nfiguration de Jalopy (suite) 

<bef orelmpl ements>f al se</bef orelmpl ements> 
<paramsMethodCal 1 If Cal 1 >f al se</paramsMethodCal 1 If Call> 
<after Label >true</afterl_abe"l> 
<use>true</use> 
</wrapping> 

<braces> 

<removeBracesBlock>true</removeBracesBlock> 
<emptyInsertStatement>false</emptyInsertStatement> 
<treatMethodClassDifferent>false 
</treatMethodCl assDi f f erent> 
<i nsertBracesIf El se>true</ i nsertBracesIf El se> 
<removeBracesDoWhi 1 e>f al se</ removeBracesDoWhi 1 e> 
<i nsertBracesWhi 1 e>true</i nsertBracesWhi le> 
<removeBracesFor>fal se</ removeBracesFor> 
<insertBracesFor>true</insertBracesFor> 
<removeBracesIfElse>false</removeBracesIfElse> 
<removeBracesWhi 1 e>f al se</removeBracesWhi 1 e> 
<ri ghtBraceNewLi ne>t rue</ri ghtBraceNewLi ne> 
<1 ef tBraceNewLi ne>true</l ef tBraceNewLi ne> 
<emptyCuddl e>fal se</emptyCuddl e> 
<insertBracesDoWhile>true</i nsertBracesDoWhile> 
</braces> 

<hi story> 

<pol i cy>Hi story . Pol i cy [di sabl ed] </pol i cy> 
</history> 
<envi ronment /> 
<chunks> 

<byComments>true</byComments> 

<byBl ankLi nes>true</byBl ankLi nes> 
</chunks> 
</pri nter> 

<transform> 

<import> 

<pol i cy>ImportPol i cy [expand] </pol i cy> 

<groupingDepth>l</groupi ngDepth> 

<grouping>javax: 2 | java:2</groupi ng> 

<sort>true</sort> 
</import> 
<misc> 

<i nsertUID>f al se</i nsertUID> 

<i nsertLoggi ngCondi ti onal >f al se</i nsertLoggi ngCondi ti onal > 
<i nsertExpressi onParenthesi s>t rue 
</insertExpressionParenthesi s> 
</misc> 
</transform> 

<general> 

<styl eName>Sun</ styl eName> 
<styleDescription>Sun ]ava Coding Convention 
</styl eDescri pti on> 
<backupLevel>0</backupLevel> 
<backupDi rectory>bak</backupDi rectory> 



lei, on definit la gestion des accolades (braces en 
anglais). 



Ce bloc definit la politique de transformation de 
code source. 



Ici, il s'agit de la transformation des lignes 
d'imports. 



Section generale, definissant principalement le 
type de convention utilise (ici, il s'agit de la con- 
vention Sun). 
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r de configuration de Jalopy (suite) 

<threadCount>l</threadCount> 

<sourceVersion>13</sourceVersion> 

<forceFormatti ng>fal se</forceFormatting> 
</genera"l> 
<messages> 

<ioMsgPrio>30000</ioMsgPrio> 

<parserMsgPrio>30000</parserMsgPno> 

<parserJavadocMsgPr~io>30000</parserJavadocMsgPrio> 

<pri nterMsgPr~io>30000</pn nterMsgPrio 

<printerJavadocMsgPrio>30000</pn'nterJavadocMsgPrio> 

<showErrorStackTrace>true</showErrorStackTrace> 

<transformMsgPno>30000</transformMsgPrio> 
</messages> 
<i internal > 

<version>4</version> 
</internal> 
</ja~lopy> 

Ce tres long fichier de configuration montre le degre de parametrage sur votre 
code source tel que vous pouvez l'obtenir avec Jalopy. II faut done retenir que ce 
produit permet de verifier la conformite de votre code source avec la convention 
choisie et qu'il offre aussi la possibilite d'appliquer automatiquement une mise 
en forme specifique. 



Autres mises en forme 

Comme toujours dans le monde du logiciel libre, la diversite et la multitude des 
projets permet de couvrir un large spectre de besoins differents avec, il est vrai, un 
risque de recoupements de fonctionnalites entre produits. Ant etant devenu un 
projet majeur, un grand nombre de projets gravitent autour de lui et, bien entendu, 
plusieurs d'entre eux s'interessent a la mise en forme du code source. 

Si Jalopy est peut-etre le projet le plus connu, il est bon de citer d'autres initia- 
tives permettant d'obtenir des fonctionnalites similaires ou complementaires. 
Cette section va proposer differents outils, meritant eux aussi d'entrer dans votre 
boite a outils de responsable qualite. 

Gestion des directives d'import de classes Java 

L'utilisation de paquetages en Java, structurant l'information, souleve diverses 
polemiques qu'il est bon d'aborder dans cette partie. En effet, par souci de confort 
pendant leur travail, certains developpeurs prennent l'habitude de realiser des 
imports en utilisant l'expression reguliere . * signifiant au compilateur le desir de 
pouvoir acceder a toutes les classes accessibles du paquetage precise. Cette pra- 
tique est evidemment tout a fait comprehensible et meme economique d'un point 
de vue temps de codage, mais elle pose beaucoup de problemes pour la mainte- 
nance d'un projet, puisqu'elle a le facheux defaut de masquer les dependances 
reelles de la classe. C'est pourquoi il est considere comme une bonne pratique de 
n'utiliser qu'un import exact des classes utilisees dans un projet. 
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C'est a ce niveau-la que les outils doivent entrer en jeu, car on ne peut obliger le 
developpeur a allonger ses cycles de developpement ni renoncer a obtenir une 
maintenance efficace de son code. Bien entendu, divers produits de developpe- 
ment (comme Eclipse) integrent deja des fonctionnalites de ref adoring de code, 
mais leur utilisation repose sur la bonne volonte des programmeurs et n'ont rien 
de systematique. 
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Figure 7-2 Capture d'ecran montrant comment lancer I'organisation des imports depuis Eclipse 



Comme d'habitude, pas de panique, Ant est la solution vous permettant d'auto- 
matiser une telle tache. II ne reste plus qua trouver un produit a meme de faire 
ce travail. 

Diverses solutions existent, telles que : 

• ImportScrubber ; 

• Cleanlmports. 

Opter pour de tels outils revient a laisser libres ses developpeurs de choisir le 
style de developpement qui leur convient le mieux tout en conservant un code 
source de qualite. Autant garder tous les avantages. . . 



OUTILS 



► http://importscrubber.sourceforge.net/ 

► http://www.euronet.nl/users/tomb/ 
cleanlmports/index.html 
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Ici, on definit une cible nommee scrub permet- 
tant de lancer la procedure de nettoyage de 
code source. 



Ici Ton procede a la declaration de la tache 
ImportScrubber (sous le nom scrub) en 
fournissant le nom de la classe Java contenant la 
tache utilisee (net. sourceforge. import- 
scrubber . ant . ImportScrubberTask) 

II s'agit la d'un AjcX'permettant de s'assurer que 
le compilateur ne supprime pas de references de 
classes (avec I'utilisation de I'option de debug) 



Voici I'appel a la tache ImportScrubber. Plus 
reduit et simple semble difficile. . . 



ASTUCE Outils reposant 
sur I'analyse des fichiers class 

ImportScrubber, comme de nombreux autres outils 
du meme type, utilise une bibliotheque d'analyse 
du code binaire (byte code Java), en I'occurrence la 
bibliotheque BCEL du projet jakarta. Etant don- 
nees les specifications de la machine virtuelle Java 
et le format des classes Java, une bonne utilisation 
du produit tiendra compte du fait qu'il vaut mieux 
eviter de declarer plusieurs classes au sein du 
meme fichier Java. C'est une des limitations de ce 
produit. 

► http://importscrubber.sourceforge.net/ 
limitations.html 



Void un exemple commente d'utilisation d'ImportScrubber, qui est la solution 
apparue la premiere. 

Extrait de script Ant demontrant I'utilisation de la tache ImportScrubber 



<target name="scrub"> 



<taskdef name="scrub" cl assname="net . sourceforge . importscrubber . 

ant.ImportScrubberTask"/> 



<javac 

deprecation="fal se" 
debug="true" 
optimize="fal se" 
srcdi r="${sourceDi r}" 
destdir="${sourceDir}" 

classpath="${libDi r}bcel . jar; ${libDi r}j unit. jar"/> 

<scrub root="${sourceDir}" classRoot="${classesDir}" 
format="top" recurse="true"/> 

<delete> 

<fileset dir="${sourceDir}" includes="**/*.class"/> 
</delete> 
</target> 

Comme le montre cet exemple, obtenir un code source propre se fait done sim- 
plement et automatiquement. Voici un exemple de resultat de l'execution de ce 
produit sur un code simple : 



Package com.foo.bar; 


package com.foo.bar; 


import java.io.*; 


import java.io. File; 


import javax. swing.*; 


i mport j ava . net . SocketOpti ons ; 


import com. us. Something; 


import java.net. URL; 


import j avax. swing.] Label ; 


import java.net.URLConnection; 


import java.io. IOException; 




import java.net.*; 


import j avax. swing.] Label ; 


import com.us.SomethingElse; 


i mport j avax . swi ng . ]Opti onPane ; 


import java.lang. Integer; 




import java.awt.*; 


import com. us. Something; 


import java.awt. Frame; 


import com.us.SomethingElse; 



Quel est l'effet de ce produit ? Organiser logiquement (alphabetiquement et 
avec une precedence aux paquetages Sun) les lignes d'import, tout en uniformi- 
sant ceux-ci en n'utilisant que des noms explicites (plus d'utilisation du .*). 
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Analyse du code source 

Meme bien formate et passant le stade de la compilation, un fichier source (qu'il 
soit en Java, en C ou dans tout autre langage) peut renfermer differents pieges 
rendant ardue sa maintenance, surtout si elle est assuree par un developpeur 
n'ayant pas developpe ce composant. 

Quels sont ces pieges ? Void une liste non exhaustive de differents travers com- 
plexifiant la tache de maintenance d'une application : 

• variables non utilisees (le developpeur charge de la maintenance pourra per- 
dre du temps a essayer de comprendre a quoi elle sert, et ce en pure perte) ; 

• parametres de methodes non utilises (meme probleme que precedemment, 
mais en affectant aussi les developpeurs utilisant cette methode) ; 

• methodes inutilisees (pourquoi aller chercher d'eventuelles bogues dans une 
methode non utilisee ?) ; 

• exceptions non traitees (par des blocs try/catch laisses vides). 

Comme nous en prenons l'habitude, on peut de nouveau proposer une solution 
du monde du logiciel libre permettant de detecter ces differents problemes. 
Cette solution se nomme PMD. 

PMD dispose d'une ouverture vers differents IDE du marche (Jedit, JBuilder, 
Emacs, Eclipse et bien d'autres) mais aussi d'une tache Ant prete a l'emploi. Le 
listing suivant illustre un extrait de build-file Ant typique. 

Extrait de script Ant demontrant comment appeler PMD depuis Ant 

<target name="pmd"> 

<taskdef name="pmd" cl assname="net . sourceforge . pmd . ant . PMDTask"/> 



<pmd rul esetf il es="rul esets/imports . xml " shortFil enames="true"> 
<formatter type="html" toFile="pmd report. html "/> 
<fileset dir="${src.dir}"> 

<incl ude name="**/* . java"/> 
</fileset> 

</pmd> 

</target> 

II est a noter que PMD vous permet de creer vos propres regies et de produire 
un fichier en XML, qui pourra etre ensuite transforme en HTML par la desor- 
mais classique tache Style. 

La page web indiquee a l'adresse ci-contre permet de recenser le resultat de 
l'execution de PMD avec une regie de detection de code inutilise sur differents 
projets Java (Ant, ORO, log4j, etc.). 



OUTIL PMD 

► http://pmd.sourceforge.net/ 



< Creation d'une cible intitulee pmd, contenant 
tous les appels necessaires a I'obtention d'un joli 
rapport HTML. 

< Comme avec toutes les taches dites externes, 
nous devons definir la tache que nous allons 
manipuler en associant a un nom (ici pmd) le 
nom d'une classe Java heritant de la classe Task 
definie dans le paquetage Ant. 

< Ici se trouve I'appel a la tache pmd en elle- 
meme. On precise le fichier contenant les regies 
guidant I'analyse. Le rapport produit est au for- 
mat HTML (pmd_report.html) et se basera 
sur tous les fichiers Java contenus dans le reper- 
toire pointe par la variable ${src.di r}. 



EXEMPLE PMD sur Ant, ORO, ... 

► http://cvs.apache.org/~tcopeland/pmdweb/ 
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Figure 7-3 Differents projets Apache passes a I'examen par PMD 



II s'agit la d'un outil reellement indispensable a tout responsable qualite, car il 
permet de prevenir des problemes sournois. L'exemple le plus frappant est sans 
aucun doute l'utilisation d'une regie refutant dans le code la presence d'excep- 
tions non traitees, car cela implique, sans reaction de la part de l'equipe menant 
a terme le projet incrimine, le fait de laisser partir en clientele un code pouvant 
ne pas fonctionner et ce sans que Ton en ait la moindre trace. 



Renforcement de I'architecture d'un projet 

Une equipe peut mettre en place de belles architectures logicielles (convenable- 
ment structurees, delimitant strictement les responsabilites de chaque couche, 
essayant de demeurer generiques et done non dependantes d'implementations 
particulieres en utilisant des motifs de conception comme la fabrication d'objets 
par des Factory), elle reste toutefois menacee par un developpeur ne jouant pas 
le jeu et utilisant des implementations particulieres sans passer par les Factory 
mises en place. 
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II est extremement difficile de detecter ce cas par revue du code source, puisqu'il 
faut analyser la (ou les) classe(s) concernee(s) avec precision pour decouvrir le 
probleme. 



Exemple concret chez BlueWeb 

Admettons que, pour realiser une tache utilitaire, nos amis de la societe BlueWeb 
aient cree une hierarchie de classes Java telle que presentee dans la figure 7-4. 
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Figure 7-4 

Hierarchie de 



Cette figure nous propose done : 

• un paquetage com . bl ueweb . foo, contenant une interface If 00 et une classe 
concrere FooFactory ; 

• un paquetage com. bl ueweb. f 00. impl, contenant les classes concretes imple- 
mentant l'interface IFoo (ici, une seule classe Foolmpl) ; 

• et enfin, un paquetage com . bl ueweb . f oobar, contenant une classe Mai n utili- 
sant les services definis dans l'interface Ifoo. 

Cette conception est assez classique, le nom des classes en lui-meme laisse pres- 
sentir que les concepteurs cherchent a separer clairement la definition des ser- 
vices et leurs implementations, de maniere a pouvoir changer ces dernieres de 
maniere transparente pour le client. Cette conception laisse done suggerer un 
sequencement d'appels du type : 

1 Obtenir une reference sur la Factory (FooFactory). 

2 Appeler la methode createObjectO sur la Factory de maniere a recuperer 
une implementation de l'interface IFoo. 

3 Puis invoquer le service desire sur l'instance creee par notre usine a objets. 

Mais que se passe-t-il si un programmeur BlueWeb distrait ou inconscient 
(peut-etre fatigue. . .) ne respecte pas ce schema et instancie directement la classe 
Foolmpl ? Ceci peut-etre fait par un extrait de code du type suivant. 



Cas d'une non-utilisation du motif de conception Factory (usine) 

package com.blueweb.apackage; 

import com.blueweb.ut-il .foo.impl . Foolmpl ; 

/** 

* ©author jm 

*/ 

public class Main { 

public static void main(String[] args) { 
new Foolmpl () ; 

} 

} 

Dans un cas comme celui-ci, toute la belle conception tombe a l'eau et l'inde- 
pendance par rapport a l'implementation nest pas respectee, ne laissant augurer 
que des problemes. 



► http://innig.net/macker/ 



Solution logicielle : Macker 

La encore, Ant va devenir votre allie en vous proposant un moyen simple et ele- 
gant de vous premunir contre ce type de manquements aux conceptions mises 
en place. Pour cela, il suffit d'integrer dans vos scripts Ant un appel au logiciel 
Macker. Ce produit permet de creer des regies (au format XML) vous permet- 
tant de verifier que vos motifs de conception sont bien respectes. Une fois 
integre dans Ant, vous pourrez dormir sur vos deux oreilles. . . 

Pour cela, Macker exige un fichier de regies listant les acces autorises et ceux 
interdits pour votre application (ainsi, dans l'exemple precedent, on interdirait 
l'acces au paquetage contenant les implementations depuis tout paquetage diffe- 
rent de com . bl ueweb . f oo). 

La syntaxe utilisee par Macker est du XML pouvant ressembler a ceci (il s'agit 
d'un des exemples simples fourni dans la distribution du produit) : 



Macker utilise un fichier de configuration XML. 
Rien d'original en fait... 



Definition d'une regie nommee Modularity 
rules 



Definition d'une variable pointant vers le paque- 
tage de base 

Iteration pour chacun des sous-paquetages con- 
tenus. On s'interesse aux noms de paquetages 
contenant la chaine i mpl . 



Definit un motif appele inside, qui permettra 
de reperer le paquetage contenant les classes 
d'implementation. Celles-ci ne devront pas etre 
accessible depuis n'importe quel paquetage. 



Fichier de configuration des regies de Macker 

<?xml version="1.0"?> 
<macker> 

<ruleset name="Modularity rules"> 



<var name="module-base" 

val ue=" net . i nni g . macke r . exampl e . modul ari ty " /> 

<foreach var="module" regex="${module-base}. (**) .imp! .**"> 



<pattern name="i nside" 

regex="${module-base}.${module}.impl .**" /> 
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<pattern name="factory" 

regex="${modul e-base} . ${modul e} . *Factory" /> 



<access-rule> 

<message>${f rom} must access the ${module} 

module through its API</message> 
<deny> <to pattern="inside" /> </deny> 
ollowxfrom pattern="inside" /x/allow> 
ollowxfrom pattern="factory" /></allow> 

</access-rule> 

</foreach> 
</ruleset> 
</macker> 

II ne reste plus qu'a observer le resultat du passage de Macker sur notre exemple 
precedent. Pour cela, adaptons la definition de la regie de maniere a scruter nos 
paquetages (com.blueweb.*) : 



Fichierde regies adapte au contexte de Blue 



Web 



<?xml version="1.0"?> 
<macker> 

<ruleset name="Modularity rules"> 
<var name="module-base" value= 



'com.blueweb" /> 



<foreach var="module" regex="${module-base}. (**) .impl .**"> 
<pattern name="inside" 

regex="${module-base}.${module}.impl .**" /> 
<pattern name="factory" 

regex="${modul e-base} . ${modul e} . '-Factory" /> 
<access-rule> 

<message>${f rom} must access the ${module} 

module through its API</message> 
<deny> <to pattern="inside" /> </deny> 
ollowxfrom pattern="inside" /></allow> 
ollowxfrom pattern="factory" /x/allow> 
</access-rule> 
</foreach> 
</ruleset> 
</macker> 

Puis utilisons un petit script Ant de test pour voir l'effet produit sur notre code. 

Script Ant demontrant comment invoquer Macker 

<project name="macker-test" default="main"> 



<!-- Declare a catch-all classpath for the project, its libs, and 
Macker --> 



Definit un autre motif, permettant de designer 
les paquetages contenant les usines a objets 
(points d'entrees obligatoires dans notre con- 
ception). 



Apres les definitions, on definit la politique 
d'acces aux paquetages. Ici, on n'autorisera 
I'acces aux classes des paquetages contenant les 
implementations que depuis d'autres classes des 
memes paquetages (pour permettre de I'heri- 
tage par exemple) ou depuis les paquetages 
contenant des usines. II est a noter que Ton defi- 
nit un message a afficher en cas de manquement 
a cette regie. 



On cree un petit projet de test denomme 
macker-test, dont la cible par defaut est la 
cible main. 
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On definit un cl asspath permettant d'acceder 
aux bibliotheques utilisees par Macker. 



Cette cible contient tout le code necessaire a 
I'invocation de Macker. 



Comme d'habitude, on declare notre tache, qui 
n'est pas connue de Ant, par un taskdef . 



Ici, on se charge d'invoquer Macker en placant 
dans le repertoire courant le fichier XML prece- 
dent (celui contenant notre regie), en prenant 
soin de le sauver sous un nom du type macker- 
rules.xml 



Ici, on precise les fichiers 
analyses. 



class devant etre 



Ici, on definit le paquetage de base (dans notre 
cas com . bl ueweb est une valeur raisonnable). 



POUR ALLER PLUS LOIN Macker 



Dans I'immediat, Macker ne dispose pas d'une sor- 
tie au format XML des informations nees de I'exa- 
men des fichiers .class de votre projet, mais 
cette tache devrait voir le jour sous peu. C'est un 
peu dommage, car cela limite I'utilisation de Mac- 
ker et nous prive de jolis rapports au format HTML 
envoyes automatiquement chaque nuit. 



Script Ant demontrant comment invo 

<path id="build.classpath"> 

<pathelement location="${build.cl asses. dir}" /> 
</path> 

<path id="macker.classpath"> 

<pathelement location="${build. classes. dir}" /> 

<fileset dir="${lib.dir}" /> 

<fileset dir="${macker.lib.dir}" /> 
</path> 

<property name="macker.cl asspath" refid="macker.classpath" /> 

<!-- Run the darn thing! --> 
<target name="macker"> 

<!-- Declare the Macker task --> 
<taskdef name="macker" 
cl assname="net . i nni g . macker . ant . MackerAntTask" 
cl asspath="${macker . cl asspath}" /> 

<macker> 

<rules dir="." includes="**/*macker*.xml" /> 



<cl asses di r="${build.cl asses. di r}"> 
<include name="**/*. class" /> 
</classes> 

<var name="basepkg" value="com.bl ueweb" /> 
<cl asspath refid="build.cl asspath" /> 

</macker> 
</target> 

<target name="main" depends="macker"/> 
</project> 

Ce script, pour pouvoir etre lance, demande la creation d'un fichier properties 
contenant la valeur de certaines variables utilisees (par exemple build. classes. dir 
ou lib. dir). Voici un exemple de tel fichier pouvant vous servir a l'adaptation sur 
votre machine : 

Fichier de proprietes necessaire a I'execution du script Ant 

lib. di r=/dvpt/ J ava/1 i b 

macker . 1 i b . di r=/dvpt/Java/macker/l i b 

src.di r=macker-test-src 

build. classes. di r=macker-bui Id 

En lancant Ant sur notre script et en utilisant le fichier de proprietes propose on 
obtient une sortie du type de la figure 7-5. 

Cela nous permet bien d'obtenir le resultat escompte : proteger notre concep- 
tion contre les raccourcis d'un programmeur inconscient. 
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_T Jerome «bijQgy.jaY jHpeir.com project*, eyiolw 




> out -buildfile build-mackec . xrol -propertyf l le macker . propert les 
Buildfile: build-roacker . xral 




- 


mac leer : 






[marker] (Checking nilefler.: nodularity rules - ..) 
[macker] (module: util.foo) 






[mauket] Main must, access the utii.luu mudule through its API 

[macker] Illegal reference 

[macker] from coro.blueweb . ©package . Ha in 

[mackrer] to coro.blueweb . util . foo . impl . Foolmpl 






[macker] [warning) major version should be between 45 and 46 for JDK <■ 
[mocker] [warning] major version should be between 45 and 46 for JDK <" 
[marker] Hanker rules checking failed (1 error) 


i.a 
1.3 




BUILD FAILED 

Iile: /home/jerorae/pcojects/eytulles/build-macker . xml :2 1 : Hacker rules checking L 
1 1 ; e -i 




Total time: 8 seconds 

■ 







Figure 7-5 Sortie ecran representant I'execution de notre script Ant 
dans le cas d'une violation de nos regies 



ALTERNATIVE Clearcase ou Visual Source Safe 

Bien entendu, Ant ne se limite pas au seul dialo- 
gue avec CVS, alors si vous utilisez ClearCase (de 
Rational) ou Visual Source Safe (Microsoft), ou 
encore Continuus, vous trouverez des taches 
optionnelles vous permettant de realiser le cou- 
plage avec votre serveur de sources. 



B.A.-B.A Check-out et check-in CVS 

Un check-out consiste a recuperer le contenu (tout 
ou partiel) d'un projet gere en configuration afin 
de le ramener sur le poste client. C'est une etape 
necessaire avant d'envisager des modifications sur 
les sources. Le check-in est le pendant de cette 
action, permettant de remonter vos modifications 
vers le serveur de sources. 

tions basiques autonsees par les gestionnaires de sources. 



Avec un outil comme Macker, on peut done disposer d'un garde-fou efficace, 
simple a mettre en oeuvre et s'integrant tres bien dans Ant et done dans votre 
processus de deploiement. La encore, pourquoi s'en priver ? 



Interaction avec CVS 

Michel, responsable qualite chez BlueWeb, n'a pas pu rester insensible a l'une 
des fameuses pratiques issues d'XP, les nightly builds. II voit en Checkstyle et 
JDepend de tres bons outils lui permettant d'obtenir chaque matin un etat de 
sante de la qualite de ce projet et par consequent n'imagine pas une seconde se 
priver d'une telle manne d'informations a bon marche. II reste cependant con- 
fronte a une difficulte technique : l'obtention des sources correspondant a la ver- 
sion desiree : il peut s'agir de la derniere version, de celle en cours de developpe- 
ment ou de toute version ulterieurement definie. 

Ne parlons plus de difficulte technique car la gestion des versions reste le pro- 
bleme de CVS et cet outil la gere bien. Ant, en bon outil de make, ne pouvait 
pas manquer de nous fournir des taches permettant de dialoguer avec notre ser- 
veur de sources. 

II n'y a done plus de problemes, il reste seulement a domestiquer la tache CVS 
et c'est justement le propos du build-file suivant, qui ne fait qu'extraire les 
sources du serveur CVS et les deposer dans le repertoire CVS-out. 

Ceci est en fait un check-out des sources (copie en local), qui est l'une des opera- 
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L'execution de ce build-file presuppose la defini- 
tion d'une variable d'environnement CVSROOT. 
Sur une machine Unix utilisant un she! 1 bash, 
ceci peut etre fait via un export CVSROOT- .. La 
tache Ant permet aussi de definir cette variable 
via le positionnement de I'attribut cvsRoot. 
Notre exemple realisant un check-out, qui est la 
commande par defaut pour cette tache, il n'y a 
pas besoin de specifier une commande via 
I'attribut command. Ce build-file suppose que le 
code source est stocke dans un module CVS 
denomme Signets : ceci est I'information spe- 
cifier par I'attribut package. 



="cree les repertoires utilises par 



Utilisation des taches CVS depuis un script Ant 

<project name="BlueWeb" defau~lt="main" basedir= 
<! — initialisation --> 
<target name="init" description 
la suite"> 
<mkdir di r="CVS-out"/> 
</target> 

<! — supprime les fichiers crees --> 

<target name="clean" description="prepare le grand menage... "> 

<delete di r="CVS-out"/> 
</target> 

<! — target principale (par defaut) — > 

<target name="main" depends="init" description="realise un check-out 
CVS des sources d'un projet"> 
<cvs dest="CVS-out" package="Signets" /> 
</target> 
</project> 



OUTIL L'auxiliaire ideal, CruiseControl 

Discipline, repetitif jusqu'a I'epuisement, rigoureux, reflechi (mais pas 
trap), obstine, communiquant, adaptatif... (si vous pensez a la descrip- 
tion de I'employe modele, vous vous trompez d'ouvrage, ce chapitre 
n'est pas extrait des aventures de Dilbert) ; il s'agit bien sur de Cruise- 
Control. 

Notre responsable qualite a repere cet outil sur Internet (http://cruise- 
control.sourceforge.net). En application du concept de continuous build, 
CruiseControl prend sur lui de verifier periodiquement si des modifica- 
tions ont ete apportees dans le gestionnaire de configuration. Lorsque 
c'est le cas, il declenche un processus de build dont il surveillera la reus- 
site... ou I'echec. 

Dans la pratique, CruiseControl est une application Java qui prend en 
charge la surveillance d'un projet. Elle se decompose ainsi : 

• ModificationSet : ces objets ont pour objectif de reperer si des 
modifications ont ete apportees aux sources du projet. Plusieurs 
implementations sont proposees par defaut pour verifier I'etat des 
gestionnaires de configuration les plus repandus (en particulier CVS). 
Michel choisit evidemment d'utiliser un CVSModificationSet, 
qu'il configure pour qu'il scrute le repertoire CVS du projet. II para- 
metre une « periode de silence » de 5 minutes. Cette periode permet 
de ne pas declencher une procedure de build entre deux commits 
d'un developpeur. 

• Builder : lorsque CruiseControl detecte au moins une modification 
et qu'elle est suivie des quelques minutes d'inactivite salvatrices, il 
declenche une procedure de build. C'est-a-dire que, pendant une 
phase de commit des sources (au cours de laquelle de nombreux 
fichiers seront deposes apres modification), cette procedure ne sera 
pas debutee. CruiseControl gere le declenchement d'une cible Ant. 
Michel configure un AntBuilder pour qu'il invoque une cible dediee 



incluse dans le bui 1 d . xml du projet. Cette cible met a jour le reper- 
toire local utilise par CruiseControl, supprime les fichiers temporaires 
et reconstruit le projet entierement (et plus encore, voir plus bas). 

• Scheduler : le Scheduler de CruiseControl permet de configurer 
le temps d'attente entre deux builds consecutifs. Michel choisit de 
laisser 5 minutes de repit a CruiseControl. 

• Publ i shers : pour que le travail de CruiseControl ne reste pas sans 
voix, un projet se voit pourvu de publishers. Ceux-ci ont en 
charge de rapporter au reste du monde le succes ou I'echec du der- 
nier build. Michel choisit de configurer un HTMLEmail Publisher. 
Celui-ci commence par creer un rapport HTML du log d'activite du 
build. Puis (tel que I'a configure Michel), il le transmet a tous les 
developpeurs dont les modifications ont ete prises en compte par ce 
build. En cas d'echec, ce rapport est envoye a la liste de diffusion 
regroupant toute I'equipe de developpement. Michel fait en sorte 
d'obtenir a chaque fois ce rapport pour suivre I'activite de Cruise- 
Control. 

• Labels : afin de clarifier le travail de CruiseControl, celui-ci associe 
a chaque tentative fructueuse un label. II s'agit par defaut d'un 
numero de build: <prefix>-<nnn>. CruiseControl fournit cette 
information sous la forme d'une propriete au script Ant. Cela permet 
au concepteur du script d'identifier la version en cours de construc- 
tion. Si le build est reussi, le numero est increments. 

Voila un scenario, peut-etre futuriste de prime abord, mais qui est la 
meilleure facon d'integrer le concept d'integration perpetuelle cher a 
Martin Fowler. II ne faut pas compter sur I'intervention de I'homme, il 
faut des outils, fournissant des rapports, permettant de signifier si oui 
ou non les modifications ont ete fructueuses. 
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Vers un build-file realist e : rassemblons les morceaux.. 



Si Michel specifie clairement ses besoins, nous sommes a ce moment prets a 
coder le build-file dedie a la qualite. On pourrait imaginer le scenario suivant : 

1 Extraire les sources de CVS (check-out). 

2 Appliquer Jalopy avec la convention de nommage preparee par Michel. 

3 Appliquer Checkstyle pour detecter les failles par rapport a la convention de 
nommage (plus importantes qu'un mauvais nombre d'espaces inseres pour 
l'indentation et autres peccadilles). Produire un rapport puis l'envoyer par 
courrier electronique. 

4 Appliquer JDepend de maniere a deceler d'eventuelles failles dans la concep- 
tion. II est bon que le chef de projet soit dans la liste des destinataires du 
courrier contenant le rapport etabli. 

5 Eventuellement realiser un check-in dans CVS permettant d'avoir un code 
« propre ». 

Suivant la formule consacree, on laissera au lecteur le soin de travailler sur un 
makefile allant dans ce sens. 



En resume... 

Ce chapitre souhaite montrer comment avec un petit peu de temps, quelques 
outils bien choisis, un chef de projet ou un responsable qualite peut gagner en 
productivite et en maitrise sur son projet. Bien entendu, les solutions proposees 
ici ne sont pas parfaites et ne couvrent pas tous les besoins, mais apres une ana- 
lyse de vos besoins specifiques et une phase de recherche vous devriez etre a 
meme d'integrer de nouveaux outils dans votre processus de build. 



chapitre 




Cette classe est placee dans le paquetage 
client. 



La classe de test cliente se connecte a un serveur 
JBoss configure avec les valeurs par defaut 
(1 099 pour le serveur JNDI) et on suppose que ce 
serveur est sur la meme machine. 



La methode main () obtient la reference sur 
I'EJB session, appelle les methodes metier puis 
affiche les resultats. 



On cree en memoire des proprietes permettant 
d'assurer la connexion au serveur JBoss. Ici ce 
serveur est suppose etre local. 
Le travail requis pour lire un fichier de proprietes 
est quasiment nul...C'est une solution que Ton 
ne saurait trap conseiller. 



Classe de test cliente accedant aux objets distrlbues (EJB) 

package client; 

import java.util .Properties; 

i mport javax . nami ng . Ini ti al Context ; 

import javax. rmi . PortableRemoteObject ; 

import ejb.Cestionnai reSignets; 

import ejb.Cestionnai reSignetsHome ; 

/** 

* classe de test cliente. 

V 

public class TestClient 
{ 

/** 

* La classique methode main(). Fait tout le travail. 

V 

public static void main(String[] args) 
{ 

Properties env = new PropertiesO I 

env. setPropertyC" java. naming. factory . i ni tial " , 

"org . jnp. i nterf aces . Nami ngContextFactory") ; 
env. setPropertyC"]' ava. naming. provider. url " , "local host : 1099") ; 
env. setPropertyC" java. naming. factory . url .pkgs" , 
"org. jboss . nami ng") ; 

try 
{ 

InitialContext jndiContext = new InitialContextCenv) ; 
Object ref = jndiContext. lookupC'Cestionnai reSignets") ; 



Implementation de la logique metier 
BlueWeb avec XDoclet 



SOMMAIRE 



Apres avoir presente les differentes couches de notre 
application maquette, il est temps pour le lecteur de rassembler 
les morceaux. Nous allons aborder l'utilisation de JBoss d'une 
maniere plus detaillee et conclure sur le tour d'horizon des 
possibilites offertes par le logiciel libre dans le cadre d'une 
architecture a 5 couches. 
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Logique metier de I'application BlueWeb 



B.A.-BA CMR 
(Container Managed Relationship) 

La gestion des relations par le conteneur (Container 
Managed Relationship) est une nouveaute de la 
norme EJB 2.1 permettant de laisser le soin au con- 
teneur de gerer les relations entre objets (entites de 
la base), et ce quelle que soit la cardinality de la 
relation (1-1, 1-n, etc.). Cette fonctionnalite n'a 
d'existence standard que par I'ajout par rapport 
aux versions precedentes des specifications d'une 
nouvelle section dans le fichier ej b- jar . xml per- 
mettant de definir les relations entre EJB entites. 



L'application maquette choisie par BlueWeb s'avere etre tres simple d'un point 
de vue logique metier : quelques regies seulement permettent I'ajout d'un theme 
ou d'un signet, il n'y a pas de calculs et le processus de validation des donnees est 
uniquement base sur des expressions regulieres. En fait, la logique est celle de la 
gestion d'un arbre de donnees (qui est d'ailleurs la structure choisie pour l'affi- 
chage de la partie cliente). 

Rappelons les principales regies : 

• Un signet est attache a un et un seul theme. 

• Un theme peut contenir des sous-themes. 

• Un theme peut contenir de 0 a n signets. 

Cette section s'interesse au code source requis pour les EJB assurant cette fonc- 
tion de gestion des donnees (signets et themes). Le code source presente ci- 
apres adopte une position classique, dans laquelle la gestion des relations pere- 
fils induites par notre logique applicative est assuree par l'application elle- 
meme. C'etait la seule solution jusqu'a l'apparition des specifications EJB 2.0. 
Elle assure done une portabilite maximale par rapport au marche des serveurs 
d'applications. Neanmoins, elle presente le defaut de laisser a notre charge un 
certain nombre de taches qui pourraient revenir au conteneur EJB ; parmi elles, 
on ne peut manquer de citer le cas de la destruction en cascade de donnees (la 
destruction d'un theme doit induire la destruction de toutes les donnees qui lui 
sont rattachees). Une alternative a cette position serait d'utiliser ce que la 
specification 2.0 des EJB appelle CMR (voir ci-contre). 



Code de PEJB session (sans etat) 



VOCABULAIRE Manager 



L'examen de code source, lie au monde EJB ou 
non, vous donnera souvent I'occasion de rencon- 
trer des classes intitulees : <XXXX>Manager. Ces 
classes, qui traduites en francais deviendraient des 
Gestionnai res <XXXX>, assurent un role de 
chef d'orchestre et pilotent le comportement de 
plusieurs classes. Elles permettent de vous abs- 
traire des details d'implementation de bibliothe- 
ques dont vous n'avez pas a comprendre le fonc- 
tionnement. Elles s'inscrivent dans la meme 
logique que le motif de conception Facade pre- 
sente dans un chapitre precedent. Notre compo- 
sant session pilotant nos composants entites va 
ainsi devenir un Manager. 



Examinons de ce pas le composant Session (EJB session sans etat) qui sert de 
chef d'orchestre pour nos deux objets entites, a savoir Theme et Signet. C'est par 
cet objet que vont transiter toutes les requetes clientes, qu'il s'agisse d'une crea- 
tion d'un theme ou d'un signet, de la mise a jour ou bien encore d'une 
recherche. 

Le code propose ci-dessous utilise des tags XDoclet (dans sa version 1.2.2). 
Ainsi, nous nous contenterons de presenter le code de la classe d'implementa- 
tion de notre EJB, laissant a XDoclet le soin de creer les parties redondantes de 
code imposees par la norme EJB (Home et Remote interface...). 

RAPPEL EJB 



Le chapitre 5 comporte des elements d'introduction a la terminologie employee dans le monde des 
EJB, done n'hesitez pas a y retourner pour vous rafraichir la memoire. 
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Code source de notre composant de session enrichi de tags XDoclet 

package ejb; 



import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
/** 

* @ejb, 

* jndi- 

* @ejb 

* @ejb, 

* 

*/ 

public 



j ava . rmi . RemoteExcepti on ; 

java.util .ArrayList; 

java.util .Iterator; 

j ava . uti 1 . Col lection; 

javax. ejb. EJBException; 

javax.ejb.SessionBean; 

j avax .ejb. Sessi onContext ; 

j avax .ejb . CreateExcepti on ; 

j avax . nami ng . Context ; 

javax . nami ng . Ini ti al Context ; 

javax. rmi . PortableRemoteObject; 

ejb.ThemeHome; 

ejb. Theme; 

bean name="Cestionnai reSignets" type="Stateless" 
-name="Cestionnai reSignets" 

ejb-ref ejb-name="SignetBean" view-type="local" 
ejb-ref ejb-name="ThemeBean" view-type="local " 



class Cestionnai reSignetsBean implements SessionBean{ 



public void ejbActi vate() throws EJBException, RemoteExcepti on { 
} 

public void ejbPassi vate() throws EJBException, RemoteExcepti on { 
} 

public void ejbRemove() throws EJBException, RemoteExcepti on { 
} 

public void setSessionContext(SessionContext argO) 
throws EJBException, RemoteExcepti on { 

} 

public void ejbCreate() { 
} 

/** 

* Cette methode fait partie de l'interface declaree de notre EJB 

* @ejb. interface-method view-type="remote" 

* @ejb. transaction type="Required" 

V 

public String[] getThemes() { 
System . err . pri ntl n("getThemes") ; 
ArrayList themes_list = new Arrayl_ist(50) ; 
try{ 

Context ctx = new InitialContext() ; 

Object ref = ctx . 1 ookup(" java : comp/env/e j b/ThemeBean") ; 
ThemeHome home = (ThemeHome) 

Portabl eRemoteObj ect . narrow(ref , ThemeHome . cl ass) ; 
Collection all themes = home . f i ndAll () ; 

for(Iterator iter = all themes. iterator();iter.hasNext();){ 
Theme curr theme = (Theme) iter.next(); 
themes list. add(curr theme. getName()) ; 

} 



Dans ce paquetage ejb, nous definissons un EJB 
session sans etat. Classe gerant la collection de 
signets... 

Bean session assurant la fagade de notre logique 
metier avec I'exterieur. 



Balises utilisees par XDoclet pour guider la gene- 
ration du code. 



Avec le tag XDoclet ejb. ejb- ref, on declare 
que cet EJB va en manipuler deuxautres (les 
entites Theme et Signet), via des references 
locales (sans passer par la serialisation Java, 
mais par des pointeurs). 



Cette premiere partie comporte les methodes qui 
doivent etre implementees pour respecter l'inter- 
face Session, a savoir : 
ejbActi vate() 
ejbPassivateO 
ejbRemoveO 
etc. 

Ces methodes sont principalement liees au cycle 
de vie d'un objet au sein du conteneur. 



Ici sont rassemblees les methodes constituant 
l'interface exposee par I'EJB. Les methodes 
metier en quelque sorte. 

L'ajout d'un theme implique d'obtenir la Home 
interface de I'EJB Theme puis creer un nou- 
vel objet Theme en lui passant les parametres 
convenables. 



Pour cela, il faut done utiliser un objet de la 
classe Context (paquetage javax. naming) 
pour proceder a la recherche (1 ookup ()). 



Puis, il faut utiliser la methode narrow() de 
I'objet PortableRemoteObject afin d'obtenir 
une reference valide. 
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Ajoute un theme en le rattachant au parent spe- 
cific... 



Ce bloc montre comment obtenir une reference 
sur I'interface Theme, puis comment utiliser un 
service (ici le finder f i ndAl 1 ()) Q. 



L'ajout d'un signet sous un theme implique 
d'obtenir la Home interface de I'EJB 
Signet, puis de creer un nouvel objet Signet 
en lui passant les parametres convenables. 



Pour cela il faut done utiliser un objet de la 
classe Context (paquetage javax. naming) 
pour proceder a la recherche (lookupO)- 
Puis, il faut utiliser la methode narrow() de 
I'objet PortableRemoteObject afin d'obtenir 
une reference valide. 

On pourrait tres facilement imaginer differents 
controles tels que la verification de I'existence 
du theme ou encore la conformite de I'URL du 
signet, et meme eventuellement ajouter un test 
permettant d'eviter les doublons . . . 



Code source de notre composant de session enrichi de tags XDoclet (suite) 

catch(Exception e){ 
e.printStackTraceO; 

} 

return (StringH) themes_list.toArray( 

new String[themes_iist.size()]) ; 

} 

* @ejb. interface-method view-type="remote" 

* @ejb. transaction type="Required" 

V 

public void addTheme(int id, String name, String remark, 
int parentld){ 

Context ctx =null ; 
try{ 

ctx = new Ini tial Context 0 I 
Object ref = ctx.lookup("java:comp/env/ejb/ThemeBean") ; 
ThemeHome home = (ThemeHome) PortableRemoteObject.narrow( 

ref , ThemeHome . cl ass) ; 
Theme theme = home.create(new Integer(id), name, remark, 

new Integer(parentld)) ; 

} 

catch(Exception e){ 
e.printStackTraceO ; 

} 

} // addThemeO 

/** 

* @ejb. interface-method view-type="remote" 

* @ejb. transaction type="Required" 

*/ 

public void addSignetUnderTheme(int signetld,int parentld, 
String name, String remark, String address){ 
System. out. println ("J 'ajoute le signet = " + name + 
" sous le parent = " + parentld); 

Context ctx =null ; 
try{ 

ctx = new Ini tial Context () ; 
Object ref = ctx.lookup("java:comp/env/ejb/SignetBean") ; 
SignetHome home = (SignetHome) PortableRemoteObject.narrow( 

ref ,SignetHome. class) ; 
Signet theme = home.create(new Integer(signetld) , name, 

new Integer(parentld) , address , remark) ; 

} 

catch (Exception e){ 
e.printStackTraceO ; 

} 

} //addSignetUnderThemeO 

/** 

* enleve tous les signets et themes... 

* Cette methode fait partie de I'interface declaree de notre E]B 

* @ejb. interface-method view-type="remote" 

* @ejb. transaction type="Required" 

*/ 
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Code source de notre composant de 

public void removeAll(){ 

System. out. println("Commence le grand menage en base... "); 

Context ctx =null ; 

try{ 

ctx = new InitiaKontextO ; 
Object ref = ctx.lookup("java:comp/env/ejb/SignetBean") ; 
SignetHome home = (SignetHome) PortableRemoteObject.narrow( 

ref ,SignetHome. class) ; 
Collection all_signets = home.findAll () ; 
for(Iterator iter=all_signets.iterator() ; 
iter.hasNext() ;){ 

Signet current_obj = (Signet) iter.next(); 
System. out. println("suppression du signet = " + 

current_obj .getName() ); 
current_obj . remove() ; 

} 

ref = ctx.lookup("java:comp/env/ejb/ThemeBean") ; 
ThemeHome theme_home = (ThemeHome) PortableRemoteObject.narrowC 

ref ,ThemeHome. class) ; 
Collection all_themes = theme_home.findAll () ; 
for(Iterator iter=all_themes.iterator() ;iter.hasNext() ;){ 
Theme current_obj = (Theme) iter.next(); 
System. out. println("suppression du theme = " + 

current_obj .getName() ); 
currentjbj . removeO ; 

} 

System. out. println("Boulot fini !!"); 

} 

catch (Exception e){ 
e.printStackTraceO ; 

} 

} // removeAll() 

/** 

* Liste les themes fils du theme specifie... 

* @param parentld, id du theme parent... 

* @return Integer[], tableau contenant les ID des themes trouves 

* @ejb. interface-method view-type="remote" 

* @ejb. transaction type="Required" 

V 

public Integer[] listThemesUnder(int parentld){ 

System. out. println("liste des themes attaches au parent = " + 

parentld) ; 
Context ctx =null ; 
try{ 

ctx = new InitiaKontextO; 

Object ref = ctx . 1 ookup (" j ava : comp/env/e j b/ThemeBean ") ; 
ThemeHome themejiome = (ThemeHome) PortableRemoteObject.narrow( 

ref , ThemeHome. class) ; 
Collection all_themes = theme_home.findByThemeParent( 

new Integer(parentld)) ; 
ArrayList list_fetched = new ArrayLi st() ; 



La suppression d'un theme implique d'obtenir la 
Home i nte rf ace de I'EJB Theme, puis d'appe- 
ler la methode f i ndAl 1 renvoyant tous les the- 
mes disponibles. En iterant sur la collection 
d'objets retournee, on applique sur chaque objet 
la methode remove (). On procede de la meme 
facon pour la suppression des signets. 



La liste des themes rattaches a un theme parent 
se fait tres simplement en appelant le finder 
declare dans le bean ThemeBean : 
findByThemeParent(). En iterant sur la col- 
lection d'objets ramenes, on peut ensuite batir le 
tableau d'objets devant etre retourne. 
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Liste les signets attaches au theme specifie.. 



Pour obtenir la liste des signets rattaches a un 
parent donne, il suffit de chercher grace au fin- 
der dedie (findBy ThemeParentO), puis de 
parcourir la liste trouvee de maniere a construire 
la valeur de retour. 



rce de notre composant de session enrichi de tags XDoclet (suite) 

System. out. println("]'ia trouve = " + a~n_themes.size() + 

" themes fils. . ."); 
for (Iterator i ter=al l_themes . i terator() ; i ter . hasNext () ; ) { 

Theme current_obj = (Theme) iter.next() ; 

list_f etched. add (current_obj .getld()) ; 

} 

return (Integer [] ) (1 i st_f etched . toArray ( 

new Integer[list_fetched.size()])) ; 



} 



catch(Exception e){ 
e.printStackTrace() ; 

} 

return null ; 

} // listThemesUnderO 

/** 

* @param parentld, id du theme parent... 

* ©return Integer[], tableau contenant les ID des signets trouves 

* @ejb. interface-method view-type="remote" 

* @ejb. transaction type="Required" 

V 

public Integer[] listSignetsUnder(int parentld){ 

System. out. println ("liste des signets rattaches au theme id = " 

parentld) ; 
Context ctx =null ; 
try{ 

ctx = new Ini tial Context () ; 

Object ref = ctx.lookup("java:comp/env/ejb/SignetBean") ; 
SignetHome signet_home = (SignetHome) 

Portabl eRemoteObject . narrow( ref , Si gnetHome . cl ass) ; 
Collection all_signets = signet_home.findByThemeParent( 

new Integer(parentld)) ; 
ArrayList list_f etched = new ArrayListO; 
System. out. println("Nombre de signets trouves = " + 
all_signets.size() ); 
for (Iterator i ter=al l_themes .iterator () ;iter . hasNextO ;){ 
Theme current_obj = (Theme) iter.next(); 
list_f etched. add (current_obj .getld()) ; 

} 

return (Integer [] ) (1 i st_f etched . toArray ( 

new Integer[list_fetched.size()])) ; 

} 

catch(Exception e){ 
e.printStackTrace() ; 

} 

return null ; 
} // listSignetsUnder() 
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Ce code n'a rien d'optimise (volontairement) dans le sens oil, a chaque appel (de 
chacune des methodes utilisees par les clients du type addThemeO ou 
listSignetsUnderO, on est condamne a refaire les memes recherches (lookup) 
par JNDI sur les objets (interfaces Home des objets Theme et Signet). 
Ceci est reellement penalisant en termes de performances et done indigne dune ver- 
sion de production. Neanmoins, l'interet pedagogique existe, puisque cela montre 
combien la mecanique generate est repetitive et done a quel point le code metier est 
reduit. II ne s'agit en fait que d'appels sur la bonne methode de recherche et d'une 
serie de traitements (mise en forme, creation ou suppression). On peut preciser que 
Ton indiquera ulterieurement un moyen permettant de faciliter la recherche des 
objets de type Home i nterfaces (voir renvoi Q dans le code, page 176). 

Enfin, comme precise dans les commentaires du listing precedent, le code pro- 
pose ici est reellement minimaliste (peut-etre trop) dans le sens ou un certain 
nombre de controles (typiquement pour l'insertion d'un nouveau signet) ne sont 
pas faits. II ne tiendra qu'au lecteur d'ajouter autant de controles qu'il le desire. 

De meme, la gestion des exceptions presentee ici ne correspond pas aux attentes 
d'une application professionnelle, mais a ce stade vous avez tous les elements en 
votre possession... 



PERFORMANCE 

Recherche des Home Interfaces 

Tres logiquement, il est generalement trivial 
d'eviter de refaire plusieurs fois le meme traite- 
ment et d'essayer de factoriser le code corres- 
pondent. Mais dans ce contexte des EJB, la 
recherche (lookup) JNDI etant une operation 
couteuse, il est extremement important de ne 
pas multiplier les requetes inutiles. L'ordre de 
grandeur du ratio de la duree d'une telle opera- 
tion relativement a la duree des differentes ope- 
rations (simples dans notre cas) du type ajout 
ou suppression de themes ou signets est de 1. 
Done, en supprimant ces recherches couteuses 
de vos methodes metier, vous pouvez diviser par 
deux le temps de reponse de chacune de ces 
operations. Attention, ce n'est qu'un ordre de 



Code des entites (EJB entity type CMP) 

Les deux classes suivantes utilisent elles aussi XDoclet pour guider la creation et 
le deploiement de vos composants. Les listings seront done limites au code des 
classes d'implementation. La balise ejb.bean avec type="CMP" definira que les 
entites seront controlees par le conteneur. 



B.A.-BA Cle primaire 



package ejb; 

import java.rmi .RemoteException; 
import javax.ejb.EJBException; 
import javax.ejb.EntityBean; 
i mport j avax . e j b . Enti tyContext ; 
i mport j avax .ejb. RemoveExcepti on ; 
i mport j avax . e j b . CreateExcepti on ; 

* Classe refl etant un signet dans la BDD. 

* Entity bean de type CMP (gere par le conteneur) 

* ©author jm 

* ©ejb.bean 

* type="CMP" 
cmp-version="2.x" 

* name="SignetBean" 
schema="Signet" 

* local -jndi-name="SignetBean" 
view-type="local" 



Une cle primaire est un champ (ou une concatena- 
tion/agregat/ensemble de champs) d'une table 
dont la valeur doit etre unique au sein de cette 
table. Elle permet done une identification a coup 
sur d'une entite. Par exemple, le numero de secu- 
rity social a 1 3 chiffres permet d'identifier de 
maniere unique un individu en France. Ce champ 
revet done une importance particuliere dans la 
declaration d'un EJB entite. 



Tags generiques (non specifiques a un serveur 
d'applications). Ici on definit une entite de type 
CMP, en utilisant le generateur conforme a la 
version 2.0 des specifications. On definit le type 
de vue (ici locale) et les noms (JNDI) ainsi que le 
type de cle primaire utilise dans la table corres- 
pondante. 
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Ici commence la declaration des finders, les 
methodes permettant de trouver une ou plu- 
sieurs entites au sein de la table. Dans ce cas, on 
definit un finder permettant la recherche par 
nom de signet, par identifiant de parent et le tra- 
ditionnel findAll() ramenant toutes les enti- 
tes de la table. II est a noter que la syntaxe utili- 
see dans les finder est celle definie par I'EJB-QL 
(voir specifications EJB). 



On definit le nom de la table en base represen- 
tant notre entite. 



Une serie de tags specifiques a JBoss permet de 
preciser le nom de la DataSource a utiliser 
ainsi que le type de mapping objet/relationnel. 
Dans ce cas, on utilise une source de donnees 
dont le nom JNDI est PostgresDS et dont le 
type est (au sens de la couche de mapping objet/ 
relationnel de JBOSS) PostgreSQL 



Cette methode est appelee par le conteneur 
lorsqu'un client fait: mon EJB. create (...). Le 
conteneur va chercher automatiquement une 
methode ejbPostCreate attendant la meme 
liste de parametres. 



e source de la classe Signet 
primkey-fiel d="id" 



@ejb.pk 



cl ass=" java . 1 ang . Integer" 



* @ejb.home generate="local" local -class="ejb.SignetHome" 

* @ejb. interface generate="local " local -class="ejb. Signet" 

* @ejb. finder 

* signature="Signet findByName(java.lang. String name)" 

* unchecked="true" 

* query="SELECT OBJECT(signet) FROM Signet signet where signet. name 

_ 7\" 

* result-type-mapping="Local" 

* @ejb. finder 

* signature="Co"nection findByThemeParent(java.lang. Integer 

* parentld)" 

* unchecked="true" 

* query="SELECT 0B3ECT(signet) FROM Signet signet 

* where signet. parent = ?1" 

* result-type-mapping="Local" 

* @ejb. finder 

* signature="Collection findAHO" 

* unchecked="true" 

* query="SELECT OBJECT(signet) FROM Signet signet" 

* result-type-mappi ng="Local " 

* 

* @ejb. persistence 

* table-name="signeLtbl" 

* @j boss. persistence 

* datasource="PostgresDS" 

* datasource-mapping="PostgreSQL" 

*/ 

public abstract class SignetBean implements EntityBean { 



* 

* Oejb.create-method 

V 

public Integer ejbCreateCInteger id, String name, Integer parentld, 
String address, String remark) 
throws CreateException { 
setld(id) ; 
setName(name) ; 
setParent(parentld) ; 
setUrl (address) ; 
setRemark(remark) ; 
return nul 1 ; 

} 



180 



Code source de la classe Signet enrichi de tags XDoclet (suit 




public void ejbPostCreate(Integer id, String name, 
Integer parentld, String address, String remark) 
throws CreateException{ } 

/** 

* @ejb.pk- field 

* @ejb. persistence 

* column-name="id" 

* @ejb. interface-method 

* @ejb. transaction 

* type="Supports" 

V 

public abstract Integer getld( ); 

public abstract void setld( Integer userld ); 

/** 

* @ejb. interface-method view-type="local" 

* @ejb. persistence 

* column-name="name" 

* jdbc-type="VARCHAR" 

* sql-type="varchar(50)" 
V 

public abstract String getName( ); 

public abstract void setName( String name ); 

/** 

* @ejb. interface-method view-type="local" 

* @ejb. persistence 

* col umn-name=" remark" 

* jdbc-type="VARCHAR" 

* sql-type="varchar(250)" 
V 

public abstract String getRemark( ); 

public abstract void setRemark( String remark ); 

/** 

* @ejb. interface-method view-type="local" 

* @ejb. persistence 

* column-name="url" 

* jdbc-type="VARCHAR" 

* sql-type="varchar(255)" 
V 

public abstract String getUrl( ); 

public abstract void setUrl( String url ); 

/** 

* @ejb. interface-method view-type="local" 

* @ejb. persistence 

* column-name="parent" 

* jdbc-type="Integer" 

* sql-type="NUMBER(10)" 

V 

public abstract Integer getParent(); 
public abstract void setParent(Integer id); 

public void ejbActi vate() throws EJBException, RemoteException { 



On definit le champ jouant le role de cle pri- 
maire. Comme pour les autres champs, la decla- 
ration est tres simple : nom de la colonne, type 
JDBC et type SQL. 
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Code source de la classe Signet enrichi de tags XDoclet (suite) 
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public void ejbl_oad() throws EJBException, RemoteException { 
} 

public void ejbPassivate() throws EJBException, RemoteException { 
} 

public void ejbRemove() 

throws RemoveException, EJBException, RemoteException { 

} 

public void ejbStore() throws EJBException, RemoteException { 
} 

public void setEntityContext(EntityContext argO) 
throws EJBException, RemoteException { 

} 

public void unsetEntityContext() throws EJBException, 
RemoteException { 
} 

} 

Void le code decrivant comment est vu notre objet Theme au sein de notre archi- 
tecture : 



Code source de I 

package ejb; 

import java. rmi .RemoteException; 
import javax. ejb. EJBException; 
import javax. ejb. EntityBean; 
import javax. ejb. EntityContext; 
i mport j avax .ejb. RemoveExcepti on ; 
i mport javax . e jb . CreateExcepti on ; 

public abstract String getName( ); 

public abstract void setName( String name ); 

* @ejb. interface-method view-type="local " 

* @ejb. persistence 

* column-name="remark" 

* jdbc-type="VARCHAR" 

* sql-type="varchar(255)" 
*/ 

public abstract String getRemark( ); 

public abstract void setRemark( String remark ); 

/** 

* @ejb. interface-method view-type="local" 

* @ejb. persistence 

* column-name="parent" 

* jdbc-type="Integer" 

* sql-type="NUMBER(10)" 
*/ 

public abstract Integer getParent(); 
public abstract void setParent(Integer id); 
/* (non-Javadoc) 

* @see javax.ejb.EntityBean#ejbActivate() 

*/ 
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Code source de la classe Theme enrichi de tags XDoclet (suite) 

public void ejbActi vate() throws EJBException , RemoteException { 
} 

/* (non-Javadoc) 

* @see javax.ejb.EntityBean#ejbl_oadO 

*/ 

public void ejbl_oad() throws EJBException, RemoteException { 
} 

/* (non-Javadoc) 

* @see javax.ejb.EntityBean#ejbPassivate() 

*/ 

public void ejbPassi vate() throws EJBException, RemoteException { 
} 

/* (non-Javadoc) 

* @see javax.ejb.EntityBean#ejbRemove() 

*/ 

public void ejbRemove() 

throws RemoveException, EJBException, RemoteException { 

} 

/* (non-Javadoc) 

* @see javax.ejb.EntityBean#ejbStore() 

V 

public void ejbStore() throws EJBException, RemoteException { 
} 

/* (non-Javadoc) 

* @see 

* javax . ej b . Enti tyBean#setEnti tyContext (javax . e jb . Enti tyContext) 

*/ 

public void setEntityContext(Enti tyContext argO) 
throws EJBException, RemoteException { 

} 

/* (non-Javadoc) 

* @see javax. ejb.EntityBean#unsetEntityContext() 

*/ 

public void unsetEntityContext() throws EJBException, 
RemoteException { 

// TODO Auto-generated method stub 

} 

} 

* 

* @ejb.bean 

* type="CMP" 

* cmp-version="2.x" 

* name="ThemeBean" 

* schema="Theme" 

* local -jndi-name="ThemeBean" 

* view-type=" local" 

* primkey-field="id" 



Ces tags XDoclet couvrent des aspects generaux 
et des specificites necessaires au deploiement 
dans JBoss. 



©ejb.pk 



cl ass=" java . 1 ang . Integer" 



©ejb.home generate="local " local -class="ejb.ThemeHome" 
@ejb. interface generate="local " local -class="ejb. Theme" 
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Classe refletant un theme dans la BDD. 

Bean entite de type CMP (gere par le conteneur). 



Cle primaire dans la base. 



Code source de I 

* @ejb. finder 

* signature="Theme findByThemeName(java. Tang. String name)" 

* unchecked="true" 

* query="SELECT OBJECT(theme) FROM Theme theme where theme. name = ?1" 

* result-type-mapping=" Local" 

* @ejb. finder 

* signature="Collection findByThemeParent(java.lang. Integer parentld)' 

* unchecked="true" 

* query="SELECT OBJECT(theme) FROM Theme theme where theme. parent = ?1 

* result-type-mapping="Local" 

* @ejb. finder 

* signature="Collection findAllO" 

* unchecked="true" 

* query="SELECT OBJECT(theme) FROM Theme theme" 

* resul t-type-mapping="Local " 

* @ejb. persistence 

* table-name="theme tbl" 

* ©jboss. persistence 

* create-table="true" 

* remove-table="true" 

* datasource="PostgresDS" 
datasource-mapping="PostgresSQL" 

*/ 

public abstract class ThemeBean implements EntityBean { 



/* 



* @ejb.create-method 

V 

public Integer ejbCreate(Integer id, String name, String remark, 
Integer parentld) 
throws CreateException { 
setld(id) ; 
setName(name) ; 
setParent(parentld) ; 
setRemark(remark) ; 
return nul 1 ; 

} 

public void ejbPostCreate(Integer id, String name, String remark, 

Integer parentld) 
throws CreateException{ } 



* ©ejb.pk-field 

* @ejb. persistence 

* col umn-name="id" 

* @ejb. interface-method 

* @ejb. transaction 

* type="Supports" 
V 
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Code source de la classe Theme enrichi de 




public abstract Integer getld( ); 

public abstract void setld( Integer userld ); 

/** < I Autre champ persistant 

* @ejb. interface-method view-type="local " 

* @ejb. persistence 

* column-name="name" 

* jdbc-type="VARCHAR" 

* sql-type="varchar(50)" 
*/ 

La declaration d'entites par XDoclet est relativement simple : il suffit, pour 
chaque champ persistant (colonne de la base), de preciser le nom de cette 
colonne, le type des donnees manipulees (en Java puis en SQL). Evidemment, 
pour le champ representant la cle primaire, il est indispensable de le preciser par 
le biais du tag @e j b . pk-f i el d. 

On peut aussi preciser qu'il est possible de creer une cle primaire composite, 
c'est-a-dire composee de differents champs. Dans ce cas, il sera indispensable de 
creer une classe MonEntitePK servant de cle primaire et d'avoir plusieurs tags 
@e j b . pk-f i el d, un pour chaque champ intervenant dans la construction de la cle 
primaire. La encore, XDoclet est votre ami et vous permet de creer automati- 
quement la classe permettant d'instancier vos cles primaires composites. 



PERFORMANCE Cles primaires composites 

II est generalement souhaitable d'eviter I'utilisa- 
tion de telles cles, qui induisent des temps de 
construction beaucoup plus importants que des 
cles simples. Bien entendu, cela ne signifie pas 
que vous ne devez jamais en utiliser. 



Generation du code et deploiement de nos 
□B dans JBoss 

Maintenant que le code source pour cette partie metier est en place, il faut : 

1 lancer l'appel de XDoclet (pour qu'il produise le code et les fichiers necessai- 
res au deploiement a notre place) ; 

2 automatiser la creation dune archive ( . jar) ; 

3 deployer notre composant dans JBoss. 

C'est ce que propose le script XML suivant (build-file Ant). 

Script Ant realisant I'invocatic 

<?xml version="1.0" ?> 

<project name="ejb-blueweb" default="default" basedir= 

<property file="${user. home}/. ${ant. project. name}- 

build. properties"/> 
<property f i 1 e="${user . home}/ . bui 1 d . properties"/> 
<property f i 1 e="buil d . properties"/> 



Un projet Ant assurant de multiples fonctions : 
traitement des sources et utilisation de XDoclet, 
compilation des EJB, empaquetage, deploiement. 



Cherche un fichier build. properties dans 
differents repertoires. 
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Charge les variables systeme. 



Definit la tache XDoclet en lui associant un nom 
de classe Java et un classpath permettant de 
charger cette classe. 



Initialisation de la structure de repertoire. 



Pour etre sur de partir sur de bonnes bases, tous 
les fichiers generes sont supprimes. 



Lance la generation des EJB par XDoclet. 



pt Ant realisant I'invocation de XDock 

<property envi ronment="env"/> 

<property name="ant. home" 1ocation="${env.ANT_H0ME}"/> 

<property name="j boss. home" 1ocation="${env. ]B0SS_H0ME}"/> 

<property name="env . COMPUTERNAME" value="${env.HOSTNAME}"/> 

<property fi ie="common .properties"/> 

<property name="1ib.di r" location="${env.LIB_HOME}"/> 

<property fiie="${~lib.di r}/~lib.properties"/> 

<property name="env . ]2EE_H0ME" 1 ocati on="${ j2ee . 1 i b . di r}"/> 

<property name="j2ee.home" 1ocation="${env. J2EE_H0ME}"/> 

<property name="j2ee. jar" 1 ocati on="${j2ee. home}/! ib/j2ee. jar"/> 

<path id="xdoclet.classpath"> 

<pathel ement 1 ocation="${l ib. di r}/log4j . jar}"/> 
<pathel ement 1 ocation="${l i b . di r}/commons-l oggi ng .jar} "/> 
<pat hel ement 1 ocat i on=" ${ j 2ee . j ar} "/> 
<fileset dir="${xdoclet.dir}/lib/" inc1udes="*. jar"/> 
</path> 

- E]B --> 

<path i d="ej b . compi 1 e . cl asspath"> 

<pathel ement 1 ocati on="${j2ee. jar} "/> 
</path> 

<path id="ejb.test.classpath"> 

<path ref i d="ej b . compi 1 e . ci asspath"/> 
</path> 

- Taskdef --> 

<taskdef name="xdoclet" 

ci assname="xdoci et . Doci etTask" 
ci asspath ref ="xdoci et . cl asspath" 

/> 

<patternset i d=" java . f i 1 es . pattern" i nci udes=" **/* . j ava"/> 

<target name="init"> 

<available property="j2ee. jar. present" file="${j2ee. jar}"/> 
<fail unl ess=" j2ee . jar . present"> 

j2ee.jar (${j2ee. jar}) is not present. 
</fai1> 
<tstamp/> 

<mkdir di r="${build .di r}"/> 
<mkdir dir="${dist.dir}"/> 
<mkdir di r="${test.di r}"/> 
<echoproperties/> 
</target> 

<target name="ciean" description="Removes build artifacts"> 

<delete dir="${buiid.dir}"/> 

<delete di r="${dist.di r}"/> 
</target> 

<target name="ejbdociet" depends="init" 

descri ption="Cenerate EJB code and descriptors'^ 
<taskdef name="ejbdoclet" 

cl assname="xdocl et . modul es . e j b . E j bDocl etTask" 
cl asspathref ="xdocl et . cl asspath" 

/> 

<mkdi r di r="${bui 1 d . di r}/e jb/gen"/> 
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Script Ant realisant I'invocation de XDoclet et le deploiemen 

<e j bdocl et destdi r="${bui 1 d . di r}/e jb/gen" 

addedtags="@xdoclet-generated at $ {TODAY}" 

ejbspec="2.0" 

force="true" 

mergedi r="metadata/e j b"> 
<fileset dir="${src.dir}"> 

<include name="ejb/*Bean. java" /> 
</fileset> 
<remoteinterface/> 
<homeinterface/> 
<1 ocalinterface/> 
<local home-interface /> 
<utilobject/> 

<jboss validatexml=" false" destdir="${build.dir}" 
datasource="java:/PostgresDS" 
datasourcemapping="PostgreSQL"/> 
<deploymentdescriptor validatexml="true"/> 
</ej bdocl et> 
</target> 

<target name="compile-ejb" depends="ejbdoclet"> 
<mkdi r di r="${build.di r}/ejb/cl asses "/> 
<javac destdi r="${build.di r}/ejb/classes/" debug="true" 
deprecation="true"> 
<src 1ocation="${buiid.di r}/ejb/gen" /> 
<src iocation="${src.di r}" /> 
</javac> 
</target> 

<target name="package-ejb" depends="compiie-ejb" 
description="Package E]B ]AR"> 
<jar destfile="${dist.di r}/antbook-ejb. jar"> 
<fileset di r="${buiid .di r}/ejb/ci asses "/> 
<metainf di r="${buiid.di r}/ejb/gen" inciudes="*.xml"/> 
<metainf di r="${buiid.di r}" inciudes="jboss.xml"/> 
</jar> 
</target> 
<!-- JBoss --> 

<target name="undepioy-an -jboss"> 
<deiete> 

<fileset di r="${jboss.home}/server/default/deploy" 
i nci udes="antbook-* . ear" 

/> 

</deiete> 
</target> 

<target name="depioy-jboss" depends="package-ejb" 
description="Dep"loy to local ]Boss"> 
<copy f i 1 e="${di st . di r}/antbook-e j b . jar" 

todi r="${j boss . home}/server/def aul t/depl oy" 

/> 

</target> 

<target name="default" depends="deploy-jboss"/> 
</project> 



Compilation des EJB generes precedemment. 



Packaging : creation du fichier archive contenant 
nos EJB. 



Le « de-deploiement » dans JBoss est aise. II suf- 
fit de supprimer notre fichier jar du repertoire 
de deploiement (server/default/deploy) 
pour annuler le deploiement des EJB dans le 
conteneur. 



Le deploiement est tout aussi aise. II suffit de 
copier notre fichier jar dans le repertoire de 
deploiement (server/default/deploy). 



Une cible ne faisant qu'appeler la cible 
depl oy- jboss puisque dependante de celle-ci. 
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Lexecution de ce script implique de fournir un fichier de proprietes 
build. properties. Nous donnons ici en guise d'exemple celui present sur une 
Linux Red Hat 9 et il vous appartient d'adapter son contenu en fonction de 
votre installation et de vos conventions de nommage des repertoires. Ici, elle est 
proche de celle utilisee pour le projet Jakarta. 

Fichier de proprietes build.properties a fournir 

xdocl et . di r=/dvpt/]ava/l i b/xdocl et-new 

build.dir= build 

j2ee.lib.di r=/dvpt/Java 

dist.dir=dist 

test.di r=testing 

jboss . home=/home/jerome/jboss 

src.di r=src 

Avant de pouvoir tester nos EJB, il ne reste plus qua parametrer la base de don- 
nees a utiliser comme source de donnees par notre serveur d'applications. 

ASTUCE Choix d'une base de donnees 

Pour apprehender la technologie des EJB, il est fortement recommande de prendre le temps 
d'installer un gestionnaire de bases de donnees, car faire I'impasse sur les composants entites 
revient a se priver d'une des facettes les plus interessantes des EJB. 

Le choix de la base de donnees est reellement tres ouvert en sachant que Hypersonic SQL livree 
avec JBoss est une base tres limitee et que I'utilisation d'Access de Microsoft (base tres popu- 
late sous Windows) est problematique et fortement deconseillee en Java. Suivant votre systeme 
d'exploitation, vos competences, la puissance de votre machine, I'utilisation de MySQL, Pos- 
tgreSQL ou Interbase sont des choix raisonnables. Pour ceux disposant d'une machine profes- 
sionnelle et de licences, ne manquez pas I'occasion de tester Oracle ou DB2 d'IBM. 



Configuration de PostgreSQL dans JBoss 



B.A.-BA Driver JDBC 



En Java, on accede a toute base de donnees par 
I'API JDBC en utilisant TCP/IP comme protocole de 
dialogue. L'utilisation d'une base de donnees 
implique done necessairement I'utilisation d'un 
pilote. Ceux-ci sont classifies en diverses 
categories ; on se contentera de conseiller I'utilisa- 
tion de pilotes JDBC de type 4. Internet regorge de 
ressources utiles vous permettant de comprendre 
cette classification et ce conseil est donne de 
maniere peremptoire. II faut aussi preciser que la 
connexion a une base de donnees se fait par une 
URL du type: 

jdbc:<dependant de la base>:// 
<nom_machi ne> : <port> : 
<autres informations> 



Cette section va detailler la procedure d'installation de PostgreSQL dans JBoss. 
Neanmoins, I'utilisation d'une autre base de donnees (la tres populaire MySQL 
ou bien Interbase de Borland, sans parler de l'indetronable Oracle) ne pose 
aucune difficulte particuliere : il vous suffira d'adopter la meme demarche et de 
modifier certains parametres. 

La configuration default comporte differents sous-dossiers dont deux impor- 
tants a nos yeux : 

• lib: dossier regroupant les differentes bibliotheques manipulees par cette 
configuration. C'est ici que vous devrez placer le jar (ou le .zip dans le cas 
d'Oracle) contenant le driver de votre gestionnaire de bases de donnees. 

• depl oy : dossier contenant a la fois vos applications deployees dans cette 
configuration et les services offerts par cette configuration. 
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JBOSS Configuration 

JBoss permet de choisir entre differentes configurations des le demar- 
rage. Configuration est ici utilise dans le sens de I'association entre un 
nom (minimal, default ou all pour les configurations standards) et 
des services (integration d'un servlet engine, qu'il s'agisse de Jetty ou 
Tomcat, d'un gestionnaire de files de messages comme JBOSSMQ, prise 
en charge du clustering, etc.). 

Pour une utilisation basique, on choisira la configuration par defaut 
(default). Le choix de la configuration utilisee est fait des le lance- 
ment du serveur, par le biais du script run.sh (ou run. bat) avec le 
parametre -c <nom_configuration>. Sans preciser ce parametre 
-c, vous lancez la configuration permettant toutes les utilisations cou- 
rantes (mais sans prise en charge du farming et du clustering). Les confi- 
gurations disponibles sont regroupees en dessous du repertoire serveur 
situe sous la racine d'installation de JBoss. 

La figure 8-1 montre la hierarchie des dossiers sous JBoss et detaille les 
configurations disponibles. 



Q £j jboss-3.2.1_tomcat-4.1.24 
B Ic3 bin 
B Q client 

a l£K lib 

B Q server 
B £3 all 
B £3 custom 
a £3 default 
B Q minimal 
B (£llf5 

Figure 8-1 Configurations disponibles sous JBoss (en standard) 

Au sein de chaque configuration, vous pouvez configurer ou non des 
bases de donnees, connecteurs et autres services. Done I'ajout de votre 
base de donnees doit se faire dans au moins une de ces configurations. 
On admettra desormais que la configuration utilisee est default 
(done <chemin_vers_jboss>/server/default). 



L'ajout d'une base de donnees passe done par plusieurs phases : 

• ajout du pilote JDBC dans le repertoire ; 

• ajout d'un service decrivant votre DataSource dans le repertoire deploy ; 

• modification du fichier de mapping objet/relationnel par defaut ; 

• suppression de la base de donnees Hypersonic SQL. 

Done, dans le cas de PostgreSQL, un petit detour par le site http://jdbc. 
postgresql.org permet d'obtenir la derniere version du driver permettant de piloter 
votre base. Ce fichier doit etre simplement copie vers le repertoire : 
<iboss_home>/serveur/default/lib. 

Puis inserez un fichier nomme postgres-service.xml contenant ce qui suit. 



Fid. 



ichier de configuration d'une source de donnees Postgres dans JBoss 3 
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<?xml version="1.0" encoding="UTF-8"?> 
<server> 

<mbean code="org . j boss . resource . connecti onmanager . 
LocalTxConnectionManager" 
name=" j boss . j ca : servi ce=Local TxCM , name=Postg resDS"> 
<depends optional -attribute-name="ManagedConnectionFactoryName"> 
<mbean code="org . j boss . resource . connecti onmanage r . RARDepl oyment" 
name=" j boss. jca: servi ce=LocalTxDS, name=PostgresDS"> 
<att ri bute name=" ] ndi Name">Def aul tDS</att ri bute> 
<attribute name="ManagedConnecti on Factory Properties'^ 
<properties> 

<conf i g-property name="ConnectionURL" type=" java. 1 ang . Stri ng"> 

jdbc : postgresql : //l ocal host : 5432/testdb 

</config-property> 

<confi g-property name="DriverClass" type="java.lang.String"> 
org. postgresql . Dri ver</config-property> 
<!--set these only if you want only default logins, 
not through ]AAS--> 



ATTENTION Version de JBoss 

Cette description n'a de sens que pour la ver- 
sion courante de JBoss, soit la version 3.x. 



Fichier de configuration d'une source de don- 
nees dans JBoss 3.x. 



II s'agit la du seul passage necessitant un para- 
metrage. Vous devez ici faire refleter votre 
installation ; dans le cas present, la meme 
machine heberge le serveur d'applications et le 
serveur de bases de donnees. Attention, ceci 
n'est pas forcement le cas dans un contexte pro- 
fessionnel. Ici la base de donnees utilisee 
s'appelle testdb. 
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Ici on utilise une authentification directe (sans ► 
passer par JAAS), le mot de passe n'est pas ren- | 
seigne, seul un nom d'utilisateur valide est 
fourni. 



ASTUCE Nommage 
d'un service dans JBoss 3.x 

JBoss presume que tout service est contenu dans 
un fichier denomme : 
<nomduservi ce>-servi ce . xml 



nfiguration d'une source de donnees Postgres dans JBoss 3 (suite) 

<config-property name="UserName" type="java.lang.String"> 

jerome</config-property> 
<config-property name="Password" type="java.lang.String"> 
</con f i g - p rope r ty> 

</properties> 
</attribute> 

<depends optional -attribute-name="01dRarDeployment"> 
jboss . j ca: servi ce=RARDepl oyment , 
name=]Boss LocalTransaction ]DBC Wrapper</depends> 
</mbean> 
</depends> 

<depends optional -attribute-name="ManagedConnectionPool"> 

<! --embedded mbean--> 

<mbean code="org . j boss . resou rce . connecti onmanager . 

DBossManagedConnectionPool" 
name=" j boss. jca: servi ce=LocalTxPool ,name=PostgresDS"> 
<att ri bute name="Mi nSi ze">0</attri bute> 
<att ri bute name="MaxSi ze">50</att ri bute> 
<att ri bute name="Bl ocki ngTi meoutMi 1 1 i s">5000</att ri bute> 
<att ri bute name="Idl eTi meoutMi nutes">15</attri bute> 
<attri bute name="Cri teri a">ByContai ner</attri bute> 
</mbean> 
</depends> 

<depends optional -attribute-name="CachedConnectionManager"> 
jboss .jca: servi ce=CachedConnectionManager</depends> 

<depends optional -attribute-name="JaasSecuri tyManagerService"> 
jboss . securi ty: servi ce=3aasSecurityManager</depends> 

<attribute name="TransactionManager">java:/TransactionManager 
</attribute> 

<!--make the rar deploy! hack till better deployment--> 
<depends>j boss . jca : servi ce=RARDepl oyer</depends> 
</mbean> 
</server> 

Attention ! Pour que le deploiement soit un succes, vous devez supprimer le 
fichier de deploiement de HSQLDB (fournie avec JBoss). Pour cela, rien de 
plus simple : supprimez le fichier hsqldb-ds.xml du repertoire deploy (et sup- 
primez eventuellement le pilote dans le repertoire 1 i b). 

La derniere etape est simple. II suffit de modifier le fichier 
standjbosscmp-jdbc.xml (disponible dans le repertoire conf) de maniere a 
changer le mapping standard. Vous trouverez ci-apres un extrait (seule partie a 
modifier en realite) de ce fichier. Et c'est tout... 

Extrait du fichier de configuration par defaut de la persistance dans JBoss 

<jbosscmp-jdbc> 
<defaults> 

<datasou rce> j ava : /Def aul tDS</datasou rce> 
<datasource-mappi ng>PostgreSQL</datasource-mappi ng> 

<create-table>true</create-table> 
<remove-tabl e>f al se</remove-tabl e> 
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Contrdler la configuration de JBoss 

Le lancement de JBoss et l'examen des traces est evidemment la premiere solu- 
tion (la plus simple et la plus naturelle). 

Pour memoire, les traces du serveur sont disponibles dans le fichier 
<jboss_home>/server/default/logs/server.log. 

Une autre solution consiste a utiliser la console JMX de JBoss, de maniere a visua- 
liser les informations exactes sur les composants deployes au sein de notre serveur 
d'applications. Avant d'en dire plus sur JMX, regardons un peu cette drole de bete 
denommee console JMX. . . La figure 8-2 montre une capture de cette console. 
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Figure 8-2 

Console JMX de JBoss vue depuis Mozilla 



NORME JMX, I'administration facile 

JMX en question... Cette norme a pour but de donner un moyen standard d'administrer les 
applications. Elle s'appuie sur des composants dits MBeans (des sortes de JavaBeans) deployes 
au sein d'un serveur particulier appele Mfiean server. Ces composants seront administrables a 
distance par le biais de protocoles (RMI, Corba) et d'adaptateurs (HTML). L'interet saute aux 
yeux apres ces quelques illustrations graphiques. II faut savoir que JMX n'a rien de propre a 
JBoss, puisque de nombreux produits adoptent dorenavant une console JMX (Weblogic depuis la 
version 6 ou Tomcat dans sa version 4.1). JBoss se distingue de nombreux autres produits car il 
ne se contente pas d'exhiber une interface conforme a cette norme : il n'est en realite qu'un 
« gros MBean server ». En effet, tout service de JBoss est code sur la base de Mbeans. 

On dispose de beaucoup d'informations dans cet ecran, mais allons droit au but 
et examinons ce qui est une des parties les plus interessantes de cet outil : 
l'examen de l'arbre JNDI. Etant donne que Ton utilise un arbre JNDI pour 
localiser nos objets au sein du serveur et que la base de donnees configuree a ete 
declaree sous le nom defaultDS, l'examen de cet arbre doit nous renseigner. . . 
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Figure 8-3 

Arbre JNDI ; on retrouve 
notre DataSource 



La figure 8-3 montre un extrait de l'arbre JNDI (JNDI View). 
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Ce premier indice montre deja que Ton a bien un objet enregistre dans notre 
annuaire JNDI avec le bon nom. . . Maintenant est-ce le bon ? Revenons a la page 
principale de la console et selectionnons ce qui est indique sur la figure 8-4. 
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L'arbre JNDI avec 
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La figure 8-5 nous montre le resultat affiche par cette page : 




Figure 8-5 

Notre DataSource a la loupe 



Bien entendu, la reussite de la connexion a la base sous-entend le fait de dis- 
poser des autorisations adequates. La declaration des droits depend fortement 
du type de moteur de base de donnees utilise. Dans le cadre de l'utilisation de 
PostgreSQL, voici un fichier type d'autorisation (pgjiba.conf) permettant de se 
connecter a Postgres en fournissant seulement un nom d'utilisateur valide. 



# TYPE DATABASE USER 

local all all 

host all all 

host all all 



IP-ADDRESS 

127.0.0.1 
192.168.1.0 



IP-MASK METHOD 
trust 

255.255.255.255 trust 
255.255.255.0 trust 



Cette authentification requiert neanmoins d'avoir ajoute explicitement un utili- 
sateur jerome dans la liste des utilisateurs Postgres (voir la commande 
createuser). Pour d'autres bases de donnees, reportez-vous a la documentation 
des produits. 



Tester nos composants 

II serait bien imprudent de commencer a travailler sur l'interconnexion entre les 
differentes couches sans meme avoir pris le soin de tester de maniere unitaire 
nos EJB. Pour cela, un petit programme de test fera tres bien l'affaire. Des outils 
affilies a JUnit sont disponibles pour l'environnement J2EE mais nous ne les 
aborderons pas ici. 



Classe de test cliente ; 



Cette classe est placee dans le paquetage 
client. 



La classe de test cliente se connecte a un serveur 
JBoss configure avec les valeurs par defaut 
(1 099 pour le serveur JNDI) et on suppose que ce 
serveur est sur la meme machine. 



La methode main () obtient la reference sur 
I'EJB session, appelle les methodes metier puis 
affiche les resultats. 



On cree en memoire des proprietes permettant 
d'assurer la connexion au serveur JBoss.Ici ce 
serveur est suppose etre local. 
Le travail requis pour lire un fichier de proprietes 
est quasiment nul... C'est une solution que Ton 
ne saurait trop conseiller. 



On obtient un contexte de nommage convena- 
blement configure. Puis on utilise cet objet pour 
chercher notre objet (Gesti onnai reSi gnets). 



La methode narrow permet d'obtenir une refe- 
rence valide. Le nom de cette methode provient 
en ligne droite du monde Corba. 



Ceci fait, on peut en demander une instance 
(obtenue depuis le pool). 



On fait du menage en effacant tous les signets et 
themes... 



Puis Ton cree quelques objets. 



package client; 

import java.util .Properties; 

i mport j avax . nami ng . Ini ti al Context ; 

import javax.rmi .PortableRemoteObject; 

i mport e j b . Gesti onnai reSi gnets ; 

import ejb.Gestionnai reSignetsHome; 

/** 

* classe de test cliente. 

*/ 

public class TestClient 
{ 

/** 



* La classique methode main(). Fait tout le travail. 

V 

public static void main(String[] args) 
{ 

Properties env = new PropertiesO ; 
env.setProperty("java. naming. factory. initial ", 

"org . j np . i nterf aces . Nami ngContextFactory") ; 
env . setProperty (" java . nami ng . provi der . url " , "1 ocal host : 1099") ; 
env . setProperty ("java . nami ng . factory . url . pkgs" , 
"org. j boss. naming") ; 

try 
{ 

InitialContext jndiContext = new Ini tial Context (env) ; 
Object ref = jndiContext. lookup("CestionnaireSignets") ; 

Gestionnai reSignetsHome manager home = 

(Gestionnai reSignetsHome) 
Portabl eRemoteObject . narrow (ref, 

Gestionnai reSignetsHome. class) ; 

Gestionnai reSignets manager = manager home. create() ; 

manager. removeAll () ; 

manager. addTheme(l,"titi","un fils rattache a la racine",0); 

manager. addTheme(2 , " fils de titi","un fils non rattache a la 
racine",l); 

String[] themes_list = manager. getThemes() I 
f or (i nt i =0 ; i <themes_l i st . 1 ength ; i ++) { 

System. out. println("theme found = " + themes_list[i]) ; 

} 

System. out. println("Adding signet " ); 
manager .addSignetUnde rTheme (1,2 , "Java" , 

"http://www.javasoft.com/", "main java site"); 

System . out .println(" \nLi ste des 

enfants du theme titi \n "); 
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} 



} 



Integer[] chiidren__id =manager.~listThemesUnder(l) ; < I Ensuite on demande quelques affichages. 

for(int i=0;i<chiidren_id.iengtn;i++){ 

System. out. print"ln("] 'ai trouve un enfant avec V id = " 
+ chiidren_id[i]) ; 

} 

System . out . pri ntl n (" \nSi gnets 

«»> rattaches au theme ID = 2"); 
Integer[] signets = manager. 1istSignetsUnder(2) ; 
f or (i nt i =0 ; i <si gnets . 1 ength ; i ++) { 

System. out. printin("] 'ai trouve un enfant avec V id = " 
+ si gnets [i]) ; 

} 

} 

catch(Exception e) 
{ 

System. out. pri ntl n (e. toSt ri ng ()) ; 

} 



Pour lancer ce programme, il suffit d'avoir un CLASSPATH contenant : 

• le chemin des classes necessaires au test (test.GientTest et le bean 
Cestionnai reSignets) ; 

• le fichier jbossal"l-j2ee. jar (fourni dans le repertoire de JBoss) ; 

• la bibliotheque de traces 1og4j (fournie avec JBoss dans le meme repertoire 
client). 

La figure 8-6 est une capture de l'ecran obtenu par l'execution de 
java client. TestCiient. 



Qjeronie maxl.javAxpert.com -/projects/eyrolles-test - Terminal No. 2 - Konsole 


HEO 


Session Edition Affkhage Signets Configuration Aide 


piUgJiBJlSlBl 


java client. TestClient ■ 
Col reference ! 1 
tbUN found = titi I i 
Chun found = file de titi 1 
AddinR signet i 




Liste des enfants du theme titi 




J'ai trouve un enfant avec 1" id - 2 




Signets rattachus au thune ID = 2 
J'ai trouve un enfant avec fi id = 1 
1 1 
1 l 

! 1 
■ 1 
! 1 
! 1 
! 1 
! 1 








Figure 8-6 Test de notre EJB 



195 



La figure 8-7 presente la trace de l'execution cote serveur. 



Hljerome^ maxi.javaxpert.com ~/jboss/t>in . i^rminal - Konsole 




1 Session Edition Afftchage Signets Configuration Aide 








16:16:13.753 INFO [STDOUT] — > ajoute theme = titi 
16:16:13,768 INFO [STDOUT] — -> ajoute theme = fils de titi 
16:16:13,78'! ERROR [STDERR] gefllienes 

16:16:13,806 INFO [STDOUT] J 'ajoute le signet = Java sous le parent = 
16:16:13,833 info [siDOUT] liste des theres attaches au parent = l 
16:16:13,837 INFO [STDOUT] J'ia trouve = 1 thenes fils... 
16:16:13,861 INTO [STDOUT] liste des signets rattaches au there id = 
16:16:13,866 INFO [STDOUT] Nonbre de signets trouves = 1 
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Figure 8-7 Les traces cote serveur 



Vbtre premier EJB est operationnel. 

Ce qu'il reste a faire pour la maquette 
BlueWeb 

II est l'heure de passer aux bilans. Commencons par celui de notre maquette. 
Que reste-t-il a implementer pour arriver aux objectifs initiaux ? 

Le cadre de l'interface cliente est pret. II reste a coder une logique permettant 
d'acceder a un modele de donnees obtenu par des requetes HTTP (appels aux 
servlets) et a transformer les donnees transportees en XML en objets Java. Cette 
partie peut etre prise en charge par quelques lignes de code utilisant Castor, ces 
lignes etant bien entendu placees dans la couche de presentation des donnees 
(servlet). 

Le framework general utilise cote serveur (servlets) est pret, il faut lui ajouter 
quelques commandes a meme d'aiguiller les requetes clientes vers les bons ser- 
vices de notre objet de facade : l'EJB session. Bien entendu, il faudra aussi dans 
cette couche utiliser Castor de maniere a serialiser les objets en XML. Pour les 
puristes, l'utilisation d'un filtre (Filter) permettrait de creer des traces applica- 
tives tres satisfaisantes. 

Du cote de la logique metier, l'effort a faire est minime, puisqu'il faut factoriser 
le code (voir methode ejbCreateO de l'EJB session), appliquer quelques tests 
permettant de minimiser les risques dus a des incoherences et ameliorer la ges- 
tion des cas exceptionnels et erreurs applicatives. Bref, tout est en place de ce 
coti-la. 

II est done laisse a la charge du lecteur desireux d'en savoir plus de finir et 
d'ameliorer ces pistes, de maniere a avoir une belle application de gestion des 
signets. 



En resume... developper avec des outils 
libres 

Nous souhaitons qua travers ces huit chapitres et cette application, le lecteur 
soit en mesure d'apprehender l'etat d'esprit necessaire au developpement avec 
les logiciels libres. De meme, ce livre espere etre un guide vous permettant de 
mettre en place votre premier EJB ou votre premiere servlet. 

Qu'il s'agisse de systemes d'exploitation (Linux ou FreeBSD), de serveurs 
d'applications (JONAS, Tomcat, Jetty ouJBoss), d'environnements de develop- 
pement (Eclipse) ou de bibliotheques (JUnit ou castor), le logiciel libre est 
desormais une realite economique et un challenge a relever. Quelle satisfaction 
que de participer, meme modestement, a un projet concernant une large com- 
munaute (la diffusion des logiciels est mondiale avec le Web) ! Mais attention, 
le choix des outils demande une attention extreme. 



Premieres lemons 
du projet Blueweb 



II est hors de question de se quitter sans prendre le temps de 
realiser une synthese de l'apprehension de ces nouvelles 
technologies par la sympathique equipe Blueweb. Cette 
synthese sera aussi pretexte a l'etude des futures versions des 
normes proposees dans cet ouvrage et a leurs implications en 
terme de methodologie de developpement. 
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Les promesses des EJB 



Dans un cas aussi simple, I'implementation des ► 
services Test forcement aussi. Ici, on se contente 
d'une multiplication par le taux de base de con- 
version... 



Macroscopiquement, les EJB doivent nous permettre d'aboutir a une grande 
reutilisation de nos composants metier. Cette promesse n'est pas sans implica- 
tion lorsqu'elle est formulee a un parterre de concepteurs maniaques des techno- 
logies objet. Avant d'aller plus en avant en conjectures philosophiques, revenons 
a du concret par l'etude d'un code fort simple. 

Un petit exemple 

Reprenons ensemble l'etude de notre composant charge d'effectuer une conver- 
sion franc vers euro (et vice-versa). On examinera par la suite la seule classe 
d'implementation (Exempl eSessi onbean . java). 

Implementation des services 

package test.ejb; 
import javax.ejb.*; 

/** 

* <p> 

* Un session Bean tres simple. Propose un seul service, le calcul 
d'une conversion franc vers euro ou euro vers franc. 

* N'a d'utilite que pour montrer la masse de travail requise pour le 
deploiement d'un E]B. 

* Bien entendu etant donnee la nature simpliste de ce composant il 
n'a pas d'interactions avec l'exterieur, 

* done ne necessite pas de dialogue avec d'autres EJB... 

* Cette classe est la classe d'implementation des services de notre 
composant (conversions) 

* En fait on peut se demander si ce n'est pas la seule utile... 
*</p> 

* ©author <a href="mai lto: jmoliere@nerim.net">jmoliere@nerim.net</ 

a> 

V 

public class ExempleSessionBean implements SessionBean { 
private float tauxDeBase = 6.55957f; 

<B> 

/** 

* Calcul euro vers franc 

* @param aConvertir, montant a convertir (euros) vers des francs 

* ©return somme convertie en francs 

*/ 

public float euroToFranc(float aConvertir) { 
System. err. println("conversion de " + aConvertir + " euros vers des 
francs"); 

return aConverti r*tauxDeBase; 

} 
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/** 

* Calcul de la conversion francs vers euros 

* @param aConvertir, montant en francs a convert! r en euros 

* ©return somme convertie en euros 

V 

public float f rancToEuro(float aConvertir){ 
return aConverti r/tauxDeBase; 

} 

/** 

* rien a f ai re dans le cas de 1' activation 

V 

public void ejbActi vate() { 
} 

* rien a f ai re dans le cas de la passivation 

V 

public void ejbPassivateO { 
} 

/** 

* le contexte est indifferent dans ce cas... 

*/ 

public void setSessionContext(SessionContext ctx) { 
} 

public void ejbRemove() { 
} 

/** 

* rien a f ai re dans cette methode 

V 

public void ejbCreate(){ 
} 

} 

Que peut-on conclure de cet extrait de code ? Notre logique metier soi-disant 
portable et reutilisable se trouve noyee au sein d'une infrastructure complexe et 
done soumise a un fort couplage. De plus, le deploiement au sein d'un conte- 
neur du type EJB complexifie grandement les taches les plus elementaires telles 
que le test. Comme toujours, le monde du logiciel libre regorge de solutions et 
Ton peut facilement trouver des extensions du framework JUnit permettant de 
realiser des tests unitaires sur nos EJB. Neanmoins, meme de telles extensions 
ne faciliteront pas la reutilisation de notre convertisseur en dehors du contexte 
EJB. II semble que l'equipe Blueweb tienne la un argument massue a l'encontre 
de cette technologie. 



E 

< Les methodes suivantes sont en rapport avec le m 
cycle de vie des objets au sein du conteneur EJB : 
activation, passivation, creation ou destruction. 



POUR ALLER PLUS LOIN Frameworks de tests de 
composants J2EE 

On peut signaler divers projets permettant 
d'outrepasser la difficulte de tests de compo- 
sants tels que les EJB avec des frameworks 
comme JUnit. Parmi ceux-ci, on peut citer 
I'excellent projet Cactus de la fondation Apache, 
disponible a I'URL suivante : http://jakarta.apa- 
che.org/cactus/ ou encore le produit JxUnit per- 
mettant d'utiliser des fichiers XML en lieu et 
place de bases de donnees. Ce dernier est dispo- 
nible a I'adresse http://jxunit.sourceforge.net/. 
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Composants et dependances 



IMPORTANT Portability 

Developper un composant attache a un fra- 
mework du type EJB revient a renoncer a I'utili- 
ser au sein d'une application autonome ou 
d'une application web sans conteneur EJB. Ceci 
est extremement dommageable puisque c'est 
ainsi renoncer aux fondements de I'approche 
objet. 



L'exemple precedent pointe le probleme fondamental lie a l'utilisation des EJB : 
les seules lignes d'imports requises par notre classe pour compiler demontrent le 
couplage evident entre notre composant et la technologie EJB. 

Ceci peut-etre resume par les diagrammes UML des figures 9-1 et 9-2. 



Convetisseur 




javax 



SessionBean 



Figure 9-1 

Le convertisseur est un bean de session 




Figure 9-2 Dependances entre paquetages 



DESIGN PATTERN Injection de dependances 

L'article de Martin Fowler est disponible sur son 
site web, a I'adresse suivante : 

► http://www.martinfowler.com/articles/ 
injection.html 

II s'agit la d'un veritable tournant dans la con- 
ception logicielle et Ton ne peut que chaude- 
ment recommander la lecture de cet article qui, 
sans etre la brique fondatrice de cette approche, 
synthetise tres bien la problematique 
sous-jacente. Cet article a aussi le merite de 
depeindre les differentes approches adoptees 
pour injecter au deploiement d'un composant 
ses dependances. On peut citer le premier article 
evoquant cette notion et la mettant a portee du 
plus grand nombre, puisqu'il s'agit d'un article 
de C++ Report disponible a I'adresse : 

► http://www.research.ibm.com/ 
designpatterns/pubs/ph-feb96.txt 

Pour etre complet dans la genealogie de ce pat- 
tern, il faut citer que son origine remonte 
comme bien d'autres au celebre centre de 
recherches de Xerox a Palo Alto au debut des 
annees 1980. 



De telles dependances physiques entre nos composants et des classes d'infras- 
tructure telles que celles proposees par le paquetage javax. ejb reduisent 
fortement la portabilite de notre code ; il nous faut done trouver un moyen de 
remplacer ces dependances. 

Injection de dependances 

Dans son article « Inversion of Control and the Dependency Injection 
Pattern », Martin Fowler decrit avec precision un remede (design pattern) per- 
mettant d'eviter de tels couplages pour nos composants. 



B.A.-BA Inversion du contrdle 

On designe ce terme de maniere abregee par 
« loC ». Mais de quoi s'agit-il ? II s'agit sim- 
plement du fait de deplacer au sein d'un fra- 
mework le code necessaire a la gestion de 
I'assemblage de vos composants, plutot que 
de gerer cet aspect explicitement. Done, tous 
les frameworks ou presque proposent cette 
fameuse inversion du controle. Ainsi, J2EE et 
les EJB proposent un tel aspect. 



ALLER PLUS LOIN Quelle forme d'loC ? 

II s'agit bien la du cceur du probleme, car avec 
ce nouveau terme nous n'avons guere fait 
avancer la science en decouvrant qu'un 
oiseau savait voler... La question a se poser 
est done « sous quelle forme va pouvoir se 
produire cette inversion du controle de 
maniere a eviter les couplages et permettre 
une meilleure approche par composants ? ». 
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II s'agit en fait de decoupler notre composant du contexte dans lequel on va 
l'utiliser, en se reposant sur un conteneur de poids mouche {lightweight con- 
tainer) procedant a ce que Ton appelle l'injection de dependances. 

En illustrant avec un autre exemple, plus concret pour beaucoup, on pourra 
apprehender tous les benefices que Ton peut retirer d'une telle conception. En 
utilisant notre application de gestion de signets, on pourrait etre tente par une 
modelisation du type de celle fournie en figure 9-3. 



a 



GestionnaireSignets 



<< access >> 



<<^reate>> 



SignetFinder 



findSignetQ 



<<comment>> 
modelisation naive 
car il y a 
dependance 
explicite entre le 
gestionnaire et une 
classe de finder 



K 



A. 



FileSignetFinder 



DbSignetFinder 



Figure 9-3 

Le gestionnaire de signets modelise 



Cette modelisation pose evidemment le probleme de dependances entre notre 
logique metier de gestion des signets et la classe utilitaire concrete manipulee 
pour le stockage des donnees (en base de donnees ou sous forme de fichiers 
texte ou XML). 

L'loC propose done de regler ce probleme de dependances en introduisant un 
objet tiers dit « assembleur » realisant l'instanciation des objets Fi nder. 

Ceci nous conduirait done a une modelisation du type de celle proposee en 
figure 9-3. 

L'utilite de cet objet assembleur est done de ramener le type de persistance uti- 
lise pour le stockage et la lecture de nos signets en base a de la configuration sur 
notre conteneur... Notre logique metier doit demeurer la meme. 

L'objet assembleur, en utilisant sa configuration, va done se trouver en position 
de determiner la classe concrete d'implementation devant etre manipulee a 
l'instant t par notre objet gestionnaire de signets. II va done se livrer a de l'injec- 
tion de dependances. . . 

Pour etre complet sur ce sujet, on peut constater qu'il y a diverses manieres de se 
livrer a cette injection de dependances : 
• injection par interfaces (IoC type 1) ; 
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B.A.-BA Conteneurs legers 

On parle aussi de micro-kernel (micro-noyaux) pour 
ces produits permettant de se concentrer sur le 
developpement de composants Java tout a fait 
standards (ce que Ton appelle parfois des POJO) et 
releguant les choix de deploiement a une etape de 
configuration. 



VOCABULAIRE POJO 

Voici encore un anglicisme sous forme d'acronyme 
pour qualifier des objets Java normaux, ceux que 
les anglais appellent des « Bons vieux objets 
Java». Ceci signifie qu'il ne s'agit pas d'EJB ou de 
toute incarnation d'une technologie specifique, 
mais plutot d'objets Java repondant a une conven- 
tion du type Java Beans. 



POUR ALLER PLUS LOIN 

Choisir un micro-conteneur 

On peut citer divers produits libres qualifiables 
de micro-conteneurs. Parmi ceux-ci, les trois 
noms les plus frequemment cites sont : 

• Spring, disponible sur le site http:// 
www.springframework.org, qui est un com- 
promis interessant entre la complexite rela- 
tive de Avalon et la simplicite de PicoContai- 
ner. 

• PicoContainer et son homologue NanoCon- 
tainer, qui sont les produits les plus legers et 
les plus simples : http://picocontainer.org 

• Avalon, le projet Apache, qui est un fra- 
mework generique permettant de batir des 
conteneurs serveurs et servant d'ossature a 
divers produits dont James, le serveur SMTP 
tres puissant de la fondation Apache : http:// 
avalon.apache.org/ 



A NOTER JBossAOP 

Jboss AOP est un des nombreux produits disponi- 
bles dans le monde Java dedies a la programma- 
tion orientee aspects. On peut citer certains de ses 
rivaux comme JAC ou AspectJ. 



• injection par accesseurs (IoC type 2) ; 

• injection par constructeurs (IoC type 3). 

On parlera de conteneurs legers pour une gamme de produits permettant de se 
livrer a ces injections de code a la volee, sans pour autant etre lies a un mode de 
deploiement (type EJB) autrement que par configuration (done simplicite de 
changement). 

On peut remarquer que ces divers produits proposent chacun une ou plusieurs 
facon(s) de voir l'injection de dependances. Ceci entrainera des optiques diffe- 
rentes de codage de vos composants suivant le framework utilise. Des trois pro- 
duits, Avalon est le seul reellement plus ambitieux, plus complexe, ce qui est 
surement cause de la mort annoncee de ce produit ; les debutants pourront done 
etre rebutes par ce produit. Spring est le projet le plus dans fair du temps et pro- 
pose l'integration de diverses couches (Web avec Webwork et Struts, bases de 
donnees avec Hibernate). PicoContainer est selon toute vraisemblance le pro- 
duit le plus facile a apprehender, quitte a opter pour un autre framework passe le 
cap de la phase d'apprentissage de cette technologie. 

Ce que Ton peut esperer de ces produits 

Cette section espere synthetiser les elements essentiels justifiant l'utilisation de 
ces produits denommes micro-noyaux. On peut choisir en toute quietude un tel 
produit si Ton souhaite : 

• se demarquer d'un fort couplage avec telle ou telle technologie, de maniere a 
envisager une reutilisation reelle de ses composants dans divers contextes ; 

• faciliter les etapes de tests et de qualification de ses composants en ne subis- 
sant pas le surcout de complexite induit par des plates-formes aussi lourdes 
queJ2EE ; 

• deplacer le couplage envers une technologie vers de la simple configuration 
(XML typiquement) en ayant la possibilite d'offrir a un composant un 
aspect de « Session bean» a la demande. 

Injection et instrumentation du code 

La programmation orientee aspects nous offre la possibilite de sortir hors de 
notre code metier divers aspects techniques transverses, tels que l'insertion de 
traces, l'audit du code, la securite ou encore la persistance comme dans le cas de 
l'utilisation conjuguee du produit JBoss AOP et de Hibernate. LAOP, depuis 
l'eclosion du projet JBoss, a trouve un bijou ornant sa couronne et demontrant a 
la face du monde la puissance de cette nouvelle facon de developper. Comme 
souvent en informatique, il faut preciser que 1A0P provient des laboratoires de 
Xerox a Palo Alto (PARC), qui ont introduit avec AspectJ (devenu un 
sous-projet Eclipse) le premier environnement Java dedie a cette technologie. 
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On peut introduire l'instrumentation du bytecode, telle que realisee dans un fra- 
mework comme Spring avec l'exemple «tarte a la creme» du logging realise a la 
volee. 

Imaginons done une classe tres simple offrant un service metier quelconque 
(nous adopterons le traditionnel « Hello World » pour ce faire) ; cette classe 
implemente une interface contenant la definition des services proposes. 

Cette classe se concentre sur son coeur de metier sans etre dotee de la moindre 
fonctionnalite technique. 

Le diagramme UML de la figure 9-4 decrit le cas de figure envisage. 



ANOTER Hibernate 



Hibernate est un autre produit heberge par le 
JBoss Group. C'est un excellent outil de mapping 
objet/relationnel, peut-etre la solution alliant la 
plus grande puissance avec les meilleures perfor- 
mances et ce sans payer le prix fort d'un apprentis- 
sage rugueux. 



Hello 



+sayHello(): void 
I 



HelloPojo 



+sayHello(): void 



Figure 9-4 

Un POJO en action 



En admettant que dans une application utilisant cet objet metier nous voulions 
obtenir des traces nous donnant le temps necessaire a l'execution de chaque ser- 
vice, void quelles solutions s'offrent a nous : 

• ajouter ces traces dans chacune des methodes visees, ce qui constitue une 
methode tres intrusive (consequences sur le code existant), d'autant plus 
lourde que le nombre de classes est important, et nous amenant a « polluer » 
notre code avec des aspects techniques transversaux ; 

• utiliser un framework d'AOP de maniere a controler l'instrumentation de 
nos services metier par fichier de configuration. 

Bien evidemment, nous nous interesserons a cette seconde facon de proceder, en 
utilisant les facultes de Spring en matiere d'AOP. 

Nous aurons done besoin de differents elements pour mener a bien notre projet 
dont le code va etre contenu dans un paquetage Java test . pojo : 

• l'interface definissant le service, appelee dans notre exemple Ihel 1 o ; 

• la classe de notre POJO appelee Hel 1 oPojo ; 

• la configuration necessaire au deploiement de notre composant ainsi qua 
son instrumentation ; 

• une classe permettant de mettre en evidence l'instrumentation du code de 
notre POJO. 
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Voici une interface permettant de definir notre 
service metier. 



Implementation minimaliste de notre interface 
IHel 1 o. On ne peut que constater I'absence de 
code de trace dans cette classe. En effet, rien 
dans le code n'indique I'entree ou la sortie dans 
une methode de notre classe, le 
System, out. print"! n() present dans la 
methode sayHel 1 o n'etant qu'une implemen- 
tation simple d'un service simpliste. 



Reference a la DTD permettant de valider ce 
document XML. 



Un contexte applicatif contient une serie de 
beans. 

Notre bon vieux POJO se trouve done cite ici. 



On introduit ici un composant technique charge 
d'ajouter le code de trace. On nomme de tels 
composants des intercepteurs. 
Ensuite, on introduit un composant virtuel iden- 
tify par la chaine Call Po jo, de maniere a 
indiquer que Ton souhaite que chaque appel a 
une methode de notre Bean Pojo entratne 
I'appel a un intercepteur. 
On constate que tous les appels a ce composant 
virtuel induiront le passage par une factory 
produisant des proxies; ces derniers seront 
instruments de maniere a declencher I'appel de 
nos intercepteurs. 



Interface implementee par I 

package test. pojo; 

/** 

* ©author jerome@javaxpert.com 

V 

public interface IHello { 
public void sayHello(); 

} 

Le fameux POJC 

package test. pojo; 

/** 

* ©author jerome 

V 

public class HelloPojo implements IHello { 

public He"lloPojo(){ 
super() ; 

} 

public void sayHello(){ 

System. out. println("Hello from sayPojo: :sayHello()") : 

} 



} 



La definition des composants dans Spring se fait par ce que Ton appelle le con- 
texte applicatif (ApplicationContext) configure en XML par le biais du fichier 
appl i cati onContext . xml dont le contenu est commente ci-apres. 



<?xml version="1.0" encodi ng="UTF-8"?> 

<!DOCTYPE beans PUBLIC "-//SPRINC//DTD BEAN//EN" "http:// 

www. springframework.org/dtd/spri ng-beans .dtd"> 

<beans> 

<bean id="Pojo" class="test.pojo.HelloPojo"/> 

<bean id="logginginterceptor" 

cl ass="test . pojo . i nterceptors . Loggi ngInterceptor"/> 
<bean id="CallPojo" 

cl ass="org . spri ngf ramework . aop . framework . Proxy FactoryBean"> 
<property name="proxyInterfaces"> 
<val ue>test . pojo . IHel 1 o</val ue> 
</property> 

<property name="i nterceptorNames"> 
<list> 

<val ue>l oggi ngi nterceptor</val ue> 
<val ue>Pojo</val ue> 
</list> 
</property> 
</bean> 
</beans> 
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Nous devons done introduire maintenant l'intercepteur charge d'ajouter les 
traces chronometrant les invocations de nos services metier. Cette classe est 
entreposee dans le paquetage test. pojo. interceptors. 




import org . aopal 1 i ance . i ntercept . Methodlnterceptor ; 
import org . aopal 1 i ance . i ntercept . Methodlnvocati on ; 



/** 



@author jerome 

V 

public class Logginglnterceptor implements Methodlnterceptor { 

/* @see org. aopalliance. intercept. MethodInterceptor#invoke( 
org . aopal 1 i ance . i ntercept . Methodlnvocati on) 

V 

public Object invoke(MethodInvocation argO) throws Throwable { 

System. out. println("Avant invocation de la methode =" 

+ arg0.getMethod() + " sur la classe = " 
+ arg0.getMethod() .getDeclaringClass()) ; 

long start=System.currentTimeMillis() ; 

try{ 

Object returned=arg0.proceed() ; 
return returned; 

} 

final ly{ 

long stop=System.currentTimeMillis() ; 

System. out. println("invocation terminee en :" + (stop-start) 
+ " ms pour la methode :"+ argO.getMethodO) ; 

} 



} 



} 



II ne nous reste plus qua realiser une petite classe de test invoquant le service 
sayHelloO a travers le framework Spring. 



Le paquetage contenant les intercepteurs asso- 
cies a nos composants metier. 
Les imports necessaires a la compilation de 
notre intercepteur. 



Un intercepteur au sens du framework AOP de 
Spring se doit d'implementer I'interface 
Methodlnterceptor, qui se contente de defi- 
nir une seule methode, la methode invoke(). 



Le code d'une telle methode se deroule en trois 
temps : 

-ce qui doit etre fait avant d'invoquer la 
methode desiree ; 

- I'appel de la methode ; 

- les traitements posterieurs a I'invocation de la 
methode. 



REMARQUE Ressemblance 



Notez bien le degre de ressemblance existant 
entre ce composant et celui propose dans le 
chapitre 5. II ne faut pas y voir une simple coinci- 
dence. 



package test. pojo; 

import java.io.FilelnputStream; 

i mport j ava . i o . Fi 1 eNot FoundExcepti on ; 

import java.io.InputStream; 

import org. springf ramework. beans. factory. xml .Xml BeanFactory; 



Paquetage ou Ton place notre code de test. 
Les imports necessaires a la compilation du pro- 
jet. 
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On doit charger notre contexte applicatif (defini- ► 
tion des Beans manipules dans notre applica- 
tion). 

Ce contexte nous permet d'initialiser une 
Factory nous permettant de rechercher les 
objets manipules par I'application. Par ce biais, 
on delegue au framework le soin de resoudre les 
dependances et d'initialiser correctement nos 
objets. 



On recherche dans la factory une reference ► 
sur un composant identifie par Call Po jo. 
Cette reference est celle correspondant a notre 
POJO instrument^ par I'intercepteur de traces. 

Ici, on manipule la reference directe a notre ► 
POJO, done cet appel ne sera pas instruments. 
Nous pourrons nous en convaincre par I'examen 
de la console... 



POUR ALLER PLUS LOIN Spring 

Ce chapitre ne pretend pas etre un manuel consa- 
cre a Spring ni a aucun autre des outils presented. 
Le lecteur interesse par ce produit trouvera avec le 
manuel de reference une tres bonne source de 
documentation. 



* ©author jerome 

*/ 

public class UI { 

public static void main(String[] args) throws FileNotFoundException 

{ 

InputStream is = new Fi leInputStream("applicationContext .xml ") ; 
XmlBeanFactory factory=new XmlBeanFactory(is) ; 



IHello hello= (IHello)factory.getBean("CallPojo") ; 
hello. sayHelloQ; 



// ici on utilise la bean definition Pojo!! 
// la sortie montrera une invocation directe de la methode 
sayHello() 

IHello hello2= (IHello)factory.getBean("Pojo") ; 
hello2.sayHelloO; 

} 

} 

Maintenant que les elements sont en place, examinons la sortie ecran corres- 
pondant a l'execution de notre application de test. 

Struts ou un autre framework web ? 

Ce sujet epineux n'ayant pas ete evoque jusque-la, il est temps de donner le res- 
senti de l'equipe Blueweb quant a cette question centrale. Cependant, avant de 
prononcer le nom du vainqueur, commencons par introduire le probleme. 

La problematique 

La mise a disposition des systemes d'information a des clients legers est un 
imperatif pour toutes les entreprises. En effet, les couts de deploiement et de 
mise a jour de clients riches sont autant d'obstacles a la proliferation de telles 
solutions, meme si certaines alternatives existent (notamment dans le monde 
Java, l'utilisation d'un produit comme Java Web Start). L'utilisation de clients 
legers offre un moyen simple de releguer les problemes de mises a jour au pla- 
card, tout en s'integrant parfaitement dans le cadre des politiques de securite 
mises en place dans la plupart des structures, puisque le protocole HTTP est un 
protocole bien maitrise et autorise dans la plupart des configurations de pare- 
feu. Le besoin de creation de pages web dynamiques est done entendu, puisque 
les applicatifs reclament de la personnalisation pour chaque client (suivi d'un 
compte bancaire, boutique en ligne, etc.). II s'agit done ici d'envisager la solu- 
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tion permettant aux equipes de developpement de produire des pages dynami- 
ques le plus efficacement possible. Comment juger de la pertinence d'un outil, 
sur quels criteres ? Examinons tout d'abord les objectifs des produits a meme 
d'etre choisis : 

• respect des normes, chartes graphiques pour faire des sites a l'ergonomie soi- 
gnee et independante des frasques des developpeurs ; 

• solidification du travail en equipe, de maniere a fournir une infra-structure 
permettant d'exploiter au mieux les forces de chaque membre d'une equipe ; 

• amelioration de la productivite de l'equipe en mettant a sa disposition divers 
outils amenant des reponses concretes a des problemes recurrents dans le 
monde du Web ; 

• integration simple dans le cycle de production d'une application. 
Maintenant que le cadre est plante, nous pouvons examiner les candidats en lice- 
Panel de produits envisageables 

On examinera ici divers produits regroupes en families, permettant de recouper 
le spectre des candidats suivant leur architecture technique, les families etudiees 
etant : 

• les frameworks MVC d'ou est issu le fameux produit Struts ; 

• les technologies a base de moteurs de templates (modeles de documents) ; 

• la categorie des inclassables, repertoriant des produits originaux, voire exoti- 
ques. 

Ces families de produits ne sont pas forcement mutuellement exclusives et peu- 
vent done etre utilisees en conjonction, en imaginant dans des cas non triviaux 
d'utiliser un framework MVC comme celui orfert par le projet Spring et un pro- 
duit de creation de vues a partir de pages modeles. Essayons de comprendre les 
differentes philosophies de produits examinees ici. 

Les frameworks MVC 

Ces produits proposent dans l'esprit un moyen d'obtenir une separation stricte 
des responsabilites entre le modele de donnees manipule, les vues graphiques 
obtenues a partir de celui-ci (interfaces graphiques) et le composant en charge 
de l'interaction avec l'utilisateur(controleur). 

Parmi les produits s'inscrivant dans cette logique, on peut citer : 

• Struts, un des projets phares de la fondation Apache, massivement adopte 
dans l'industrie et tres en vogue dans les media specialises ; 

• Barracuda, un projet tres proche dans l'esprit, mais dont le developpement 
est stoppe depuis plusieurs mois ; 

• JSF ou Java Server Faces, qui est concu pour supplanter Struts, puisqu'il est 
mene par le concepteur de Struts en cooperation avec un groupe d'experts 
internationaux ; e'est un projet encore recent et en pleine evolution. 



Apres avoir presente l'approche philosophique adoptee par ces produits, il est 
bon de s'interesser au ressenti des utilisateurs de ce type de technologie, argu- 
ments principalement tires de la communaute d'utilisateurs Struts : 

• L'impact sur le cadre apporte au travail est certain et universellement 
reconnu. 

• L'influence sur le respect des chartes graphiques est indeniable. 

• Lintegration au sein d'un projet en equipe demande de l'organisation et des 
outils (du type easystruts) car le partage du fichier struts-config.xml est 
une veritable entrave dans le cas d'un developpement en equipe. 

• Les outils d'amelioration de la productivite (validation de formulaires ou 
couches d'internationalisation) n'apparaissent pas reellement indispensables 
car souvent trop limites. 

En approfondissant un peu, on va ecorner un peu plus cette technologie en 
constatant quelques limites de ce produit : 

• Si le Design Pattern MVC ne s'interesse en rien aux types de vues renvoyees 
vers les postes clients, il est evident de constater le couplage fort entre Struts 
et le Web. C'est assez decevant, mais seulement conceptuellement, car il faut 
reconnaitre qu'il s'agit la d'un besoin plus que frequent actuellement. A titre 
d'exemple, meme si la delivrance d'une interface graphique SWING est 
possible avec Struts, ceci reclame beaucoup de travail et de methodologie. 

• II est dommageable pour ces technologies de constater le faible degre de reu- 
tilisation des composants graphiques qu'elles induisent. Ceci va totalement a 
l'encontre de l'adoption de technologies objet, propices a la creation de com- 
posants reutilisables. II parait ainsi tres surprenant d'etre oblige de redeve- 
lopper de projet en projet des composants tels que des formulaires de trans- 
fert de fichiers {upload de documents). 

• II est extremement facile (c'est un effet pervers et non une obligation inhe- 
rente a la technologie) de voir des pages realisees sous la forme de concate- 
nation de diverses technologies (HTML standard, Javascript, VB Script et 
scriptlets Java). Ce point est crucial, car ce type de derive rend vain l'espoir 
de voir les responsabilites separees entre les membres d'une equipe. Des 
pages constitutes de quatre langages differents doivent etre maintenues par 
un bon developpeur web connaissant Java : un comble pour une technologie 
censee favoriser la separation des responsabilites. 

• L'utilisation massive de JSP suivant les recommandations Struts pose un grave 
souci pour le travail des developpeurs, qui n'est pas directement imputable a 
Struts. En effet, une JSP n'etant qu'une page transformee a la volee par le con- 
teneur en une servlet Java, le developpeur obtiendra en cas d'incident a l'execu- 
tion un rapport d'erreurs contenant des references a des classes inconnues. Les 
phases de mise au point d'applications web utilisant Struts doivent etre eva- 
luees avec finesse par le chef de projet en tenant compte de ce facteur. 

• La multiplication des bibliotheques intitulees tags libraries a aussi l'effet per- 
nicieux de voir de plus en plus de pages JSP briser le confinement architec- 



tural qui est celui souhaite par tous. Certaines bibliotheques de ce type per- 
mettent en effet de realiser des appels a la base de donnees directement 
depuis une JSP.Ou est done passe le MVC dans un tel cas de figure ? 

Enfin, on pourra preciser qu'il ne faut pas negliger les difficultes que peuvent 
poser de tels produits, qui dans tous les cas demandent de l'apprentissage. 

Technologies a base de modeles de documents 

Les moteurs de templates sont des composants (Java dans notre contexte) des- 
tines a rendre le processus de delivrance d'un document aussi simple et rapide 
que possible, dans la mesure ou ce document peut-etre envisage comme un 
assemblage de sections types parametrees par un contexte d'utilisation. Ces pro- 
duits doivent etre percus comme des moyens de delivrer des vues (au sens du 
MVC) et peuvent done etre integres dans d'autres produits examines ici 
(comme dans le cas de l'extension de Spring dediee au Web). 

Ainsi, imaginons le cas d'une boutique en ligne souhaitant notifier par courrier 
electronique tout acheteur suite au passage d'une commande par celui-ci. Ce 
courrier pourrait etre presente sous la forme suivante : 

Cher Monsieur Martin, 

l'equipe Maboutique.com vous remercie de votre confiance suite a 
Tachat fait ce jour: 20/11/2004 a 8h et compose des articles suivant: 
Produit QuantitePrix Unitaire euros 

Cahiers du programmeur ]ava tome 2 - J .MOLIERE1225 
A kind of Blue - Miles Davisll4,80 

Soit une commande d'un montant de 39,80 euros regie par carte bleue. 
A bientot sur MaBoutique.com 

Un tel courrier peut etre vu comme le fruit d'une transformation d'un document 
original en tenant compte d'informations contextuelles, dans notre cas : 

• nom du client ; 

• date du jour; 

• heure de la commande ; 

• detail des composantes de la commande ; 

• montant de la commande ; 

• type de reglement effectue. 

Ce document original pourrait etre ecrit de la facon suivante : 
Cher/e Monsieur/Madame ${client.name}, 

l'equipe Maboutique.com vous remercie de votre confiance suite a 
1 'achat fait ce jour: ${date} a ${time} et compose des articles 
suivant: 

Produit Quantite Prix Unitaire euros 

${commande.item} ${commande.item.nb} ${commande.item.prix} 



POLEMIQUE Struts 

Cette section peut choquer certains lecteurs, qui 
peuvent argumenter que sur tel ou tel projet, ils 
ont pu obtenir une application tres propre concep- 
tuellement. Les critiques prononcees ici ne se veu- 
lent que I'expression de retours d'experience con- 
crete et ne pretendent en hen decrire toutes les 
applications Struts. 
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Soit une commande d'un montant de ${commande.montant} euros reglee par 
${commande.type. reglement}. 

A bientot sur MaBoutique.com 

A partir d'un tel modele et des informations du contexte (acces aux composants 
Java contenant les informations), il est facile d'imaginer le travail effectue par un 
moteur de templates... 



Context 



Template 



PRECISION J Byte 



La figure 9-5 mentionne un autre produit (JByte) 
qui, a defaut d'etre celebre, brille par son extreme 
legerete, puisqu'en 8 kilo-octets, il vous ouvre la 
perspective d'utilisation d'une telle technologie. 



XSLT 



La transformation de documents XML guidee par 
des feuilles de style (elles aussi exprimees en XML) 
permet d'injecter, dans un composant, une source 
d'informations (fichier XML) et une feuille de style 
(extension en . xsl ), de maniere a produire diver- 
ses sorties en fonction de la feuille de style choisie. 
Des produits comme Cocoon utilisent cette techni- 
que dans un environnement web, tandis que Doc- 
Book est un produit destine a la creation de livres 
ou articles en XML. 



POUR ALLER PLUS LOIN XSLT 

Le lecteur desireux d'en savoir plus sur XSLT et sa 
manipulation en Java est invite a se reporter 
a I'excellent ouvrage sur Java & XML par 
Renaud Fleury publie par les Editions Eyrolles... 



Template engine 
JByte/FreeMarker/velocity 



Output - Document 
Figure 9-5 Utilisation d'un moteur de templates 

Les produits les plus remarquables dans le monde Java sont : 

• Freemarker, produit stable et performant, peut-etre trop a en juger par la 
complexite permise par son langage de script ; 

• Velocity de la fondation Apache, stable, robuste et puissant, tout cela avec 
un langage de script (VTL) reduit au strict minimum : un produit a posse- 
der dans sa boite a outils ; 

• StringTemplate, un produit issu des travaux de Terrence Parr, l'auteur du 
generateur de parseur de renom : ANTLR. Cet outil est disponible a 
l'adresse suivante : http://www.stringtemplate.org/. 

Une autre facon d'envisager ce type de transformations guidees par un modele 
consiste en l'utilisation d'un composant proposant la technologie XSLT. Cette 
facon d'apprehender le probleme permet de decoupler completement le modele 
de sortie du modele de donnees. On peut citer divers composants Java dans le 
monde du logiciel libre proposant la norme XSLT : 

• Xalan de la fondation Apache, 

• Saxon. 
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XSLT est une technologie attrayante mais pose encore bien des soucis en 
matiere de performance (transformations complexes et lourdes). De plus, il est 
bon de noter que XSL, la technologie normalisee permettant de developper des 
feuilles de style, est assez complexe a maitriser. 

Les principaux benefices que Ton peut retirer de l'utilisation d'un moteur de 
templates sont : 

• respect d'une charte graphique, argument evident puisque le modele de 
document serait dans le cas du Web une page HTML, utilisant une feuille 
de style (CSS) issue de la charte graphique de l'entreprise ; 

• simplicite de l'API propre a ses produits ; 

• performances excellentes puisque des produits comme Velocity disposent de 
caches reduisant au minimum les lectures de donnees sur le disque. 

Dans le cas d'un environnement web, ce type de technique peut paraitre delicat 
a mettre en oeuvre, car il reclame une bonne connaissance de la servlet API (ser- 
vlets, filtres HTTP, listeners de session...). 

Les inclassables 

Ces produits originaux ne peuvent etre classes qu'en un groupe esoterique. Nous 
nous interesserons a deux de ces produits particulierement originaux : 

• Tapestry, un projet issu de la fondation Apache (sous-projet Jakarta), 

• Flex de Macromedia, une solution proprietaire fort originale. 

Tapestry, le developpement 100 % web 

Ce projet est en fait une libre adaptation dans l'environnement Java du fra- 
mework concu par Apple pour le langage Objective-C. II affiche clairement ses 
objectifs : 

• permettre une reutilisation des composants graphiques, par le concept d'une 
palette enrichie de projets en projets ; 

• rendre possible la stricte separation des responsabilites en cantonnant les 
developpeurs Java a l'elaboration de composants (developpes en Java), tandis 
que les developpeurs web travaillent dans l'environnement qui leur est 
familier : le Web, l'inclusion de composants dans les pages HTML se faisant 
par le biais d'une balise HTML standard, reconnue par les outils de deve- 
loppement type Dreamweaver ou Quanta sous Linux ; 

• eviter la complexite de la phase de mise au point d'une application inherente 
a l'utilisation des technologies comme les JSP en fournissant toutes les infor- 
mations utiles au developpeur. 



APARTE Le probleme du 
developpement avec des JSP 

Toute personne ayant manipule cette technologie 
s'est trouvee confronted a une erreur dans une 
page induisant une exception traduite en une pile 
d'appels obscurs puisque inconnus du developpeur 
de la dite page. II s'agit la du probleme le plus per- 
turbant lors d'un developpement avec cette tech- 
nologie. 
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ALTERNATIVE Lazlo 

Ce projet commercial a la base, vient d'etre offert 
a la communaute. II se pose en concurrent direct 
de Flex et est disponible a I'adresse suivante : 
► http://www.laszlosystems.com/ 



Flex, la solution joker de Macromedia 

Decu par la pauvrete des interfaces proposees a un utilisateur de site web par le 
langage HTML (meme complete par un attirail de scripts JavaScript) ? Alors 
peut-etre que la solution Flex est faite pour vous. 

Macromedia, editeur du celebre langage Flash conferant un dynamisme supe- 
rieur aux pages web (jeux, animations graphiques), propose ce produit permet- 
tant de creer des pages incluant des appels a des composants Flash produits 
dynamiquement. Ces scripts Flash sont decrits en XML (fichiers d'extension 
. mxml ) et compiles en Flash par une application web deployee sur un serveur 
J2EE (Tomcat, Jetty ou JBoss par exemple) et communiquant avec une couche 
de services metier par le biais de services web en SOAP (XML sur HTTP). Ce 
type d'architecture se traduit par une vue du type de celle presentee en 
figure 9-6. 



HTTP 




flex 



serveur J2EE 



Figure 9-6 Architecture de Flex 

Elle peut aussi se traduire sous la forme d'un diagramme de sequences UML 
fourni en figure 9-7. 

Basiquement, Flex se presente done sous la forme dune application web (.war) 
deployee au sein de votre serveur d'applications. Cette application web se com- 
pose de differents elements : 

• un cache d'applications stockant les fichiers . SWF envoyes aux clients, 

• un module d'analyse des descripteurs d'applications Flex (fichiers .mxml) 
permettant de resoudre les dependances d'une application, 

• un compilateur generant les fichiers a destination du module Flash installe 
sur le poste client. 

En mode de developpement, une requete emise depuis le poste client peut se 
traduire parle sequencement suivant (figure 9-8). 
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Figure 9-7 Architecture de Flex (UML) 
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Figure 9-8 Compilation d'un script a la volee 



Synthese des solutions evoquees 

Le tableau suivant presente une vue synthetique des divers produits preserves. 



Produit 


Licence 


Doc 


Avantages 


Inconvenients 


Struts 


libre (ASF) 


livres, articles 


structurant, 
populaire 


complexite, 
loudeurde 

Integration, mise au point de I'applica- 
tion. 


Moteurs de modeles 


diverses 


suivant le produit 


API simple, 
performance 


travail de conception necessaire. 


Flex 


proprietaire 


fournie avec le produit 


Puissance de I'interface gra- 
phique delivree au client. 


Flex se comporte comme une boTte noire. 
Disponibilite d'un player Flash compati- 
ble avec Flex sur d'autres plates-formes 
que Linux. 


Tapestry 


libre 


livres, articles 


separation du travail, reutilisa- 
tion de composants 


limitation de I'interface graphique deli- 
vree a du simple HTML. 



JMS 

L'equipe Blueweb ne peut que deplorer le fait que ce projet pilote n'ait pu 
entrainer l'utilisation de cette API standard dans le monde Java. L'introduction 
d'un gestionnaire de messages aurait ete purement artificielle dans le cadre du 
cahier des charges de l'application de gestion des signets. 



POUR ALLER PLUS LOIN JMS 



Le lecteur interesse par cette norme trouvera un 
chapitre complet et du code exemple dans I'ouvrage 
a paraitre aux editions Eyrolles : Comprendre et 
exploiter un serveur & applications J2EE libre. 
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DERNIERE MINUTE Aval on, un futur plus qu'incertain 



■3 



II semblerait que ce projet n'ait pu renaTtre des cendres du projet compagnon de ce dernier dans 
la fondation Apache : le projet Phenix. Avalon semble done definitivement mort et enterre et 
n'est done pas un projet a choisir a la legere. 

II n'en demeure pas moins que ce produit a ete utilise avec succes dans divers projets dont 
James, meme si les puristes peuvent regretter le type d'injection de dependances qu'il propose. 



Conclusion 

Voila qui acheve le voyage entrepris par Blueweb dans le monde vaste et com- 
plexe des technologies J2EE. Nous esperons que ce livre vous fournira les pistes 
vous permettant d'apprehender globalement cette plate-forme vaste et com- 
plexe, d'operer des choix efficients et realistes et de trouver des references vers 
des ouvrages a meme de satisfaire votre curiosite. 

Javamment... 
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Securiser un reseau Linux 2 e edition 

Bernard BOUTHERIN, Benoit DELAUNAY - N°11445, 2004. 
A travers une etude de cas generique mettant en scene un 
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ment contre les intrusions, denis de service et autres attaques : 
filtrage des flux, securisation par chiffrement avec SSL et [Open] 
SSH, surveillance quotidienne... On utilisera des outils 
Linux libres, reputes pour leur efficacite. 

□ebian 

Raphael HERTZOG - N° 11398, 2004. 

Debian GNU/Linux, distribution Linux non commerciale extreme- 
ment populaire, est reputee pour sa fiabilite et sa richesse. Sou- 
tenue par un impressionnant reseau de developpeurs dans le 
monde, elle a pour mots d'ordre I'engagement vis-a-vis de ses uti- 
lisateurs et la qualite. 

BSD 2 e edition 

Emmanuel DREYFUS - N°11244, 2003. 

Ce cahier revele les dessous d'UNIX et detaille toutes les opera- 
tions d'administration UNIX/BSD : gestion des comptes, initiali- 
sation de la machine, configuration des serveurs web, DNS et de 
messagerie, filtrage de paquets... Autant de connaissances 
reutilisables sous d'autres systemes UNIX, et en particulier Linux. 

Chez le me me editeur 
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Les Cahiers du programmeur 

Mac OS X 

Gestionnaire de photos avec Cocoa, REALbasic 
et WebObjects. 

Alexandre Carlhian, Jacques Foucry, Jean-Philippe Lecaille, Jayce 
Piel - avec la collaboration d'Olivier Gutknecht - N°1 1 1 92, 2003 . 
Realisez un gestionnaire de photos consumable via le Web avec 



Cocoa et Objective-C, REALbasic et WebObjects. 
PHP 5 

Application de chat avec PHP 5 et XML 
Stephane Mariel - N°11234, 2004. 

□e la conception a I'exploitation, on creera une application de dis- 
cussion en ligne en PHP 5 respectant les methodes eprouvees du 
developpement web : architecture MVC, conception modulaire avec 
les interfaces, sessions, gestion d'erreurs et exceptions, echanges 
XML et transformations avec DOM, XPath et SimpleXML. 

PHP isi 

Ateliers Web professionnels avec PHP/MySQL 
et JavaScript. 

Philippe CHALEAT et Daniel CHARNAY - N°1 1089, 2002. 
En une douzaine d'ateliers pratiques, allant de la conception 
d'aides multi-fenetrees en JavaScript a la realisation de services 
Web, en passant par les templates PHP et les annuaires LDAP, 
on verra qu'autour de formulaires HTML, on peut sans mal rea- 
liser des applications legeres ergonomiques et performantes. 

PostgreSQL 

Services Web professionnels avec PostgreSQL 
et PHP/XML. 

Stephane MARIEL - N°1 1 1 66, 2002. 

Ce cahier montre comment realiser simplement des services 
Web avec PostgreSQL, PHP et XML. Le developpeur apprendra 
a modeliser sa base, tirer parti de la richesse de PostgreSQL 
[transactions, procedures stockees, types de donnees evo- 
lues...], optimiser ses performances et en automatiser I'admi- 
nistration, sans oublier la realisation d'un affichage dynamique 
avec XSLT. 

Cans la collection 
Acces libre 

□ebuter sous Linux. 

S. Blondeel, H. Singodiwirjo. - N°11349, 2004, 328 pages. 
Cet ouvrage guidera des utilisateurs motives, qu'ils aient ou non 
utilise un systeme MS-Windows, vers la connaissance, I'utilisa- 
tion et I'administration du systeme libre et gratuit Linux, qui offre, 
outre sa puissance, les indispensables de tout poste de travail : 
traitements de texte, tableurs, mail, navigation Web, message- 
rie instantanee, jeux, multimedia. 

OpenOffice.org efficace. 

S. Gautier, C. Hardy, F. Labbe, M. Pinquier. 

N°11348, 2004, 350 pages. 

OpenOffice.org, suite bureautique gratuite tournant sous 
Windows, Linux et Mac OS X, inclut tous les modules habituels : 
traitement de texte, tableur de calcul, presentation, dessin, 
formules... Ecrit par les chefs de file du projet francais Open- 
Office. org, cet ouvrage montre comment optimiser son environ- 
nement de travail et I'utilisation de chaque module d'OOo, 
comment s'interfacer avec des bases de donnees telle MySQL, 
et offre enfin un precis de migration. 

Reussir un site Web dissociation. . . 

avec des outils gratuits. 

A.-L. Quatravaux, □. Quatravaux. - N°11350, 2004, 280 pages. 
Souvent peu dotee en moyens, une association doit gerer ses 
adherents et membres, faciliter I'organisation du travail entre 
eux, etre visible et soigner son image. Depuis le choix de I'he- 
bergement jusqu'au referencement, en passant par la person- 
nalisation graphique sous SPIP, la configuration d'un serveur d'e- 
mailing et la creation de listes de diffusion, ce livre explique 



